Affine on Linkzz's Blog

内网自部署存储迁移到自部署的 S3

Sat, 02 May 2026 00:00:00 +0000

内网自部署存储迁移到自部署的 S3

1. 存储的烦恼

我日常会使用一些自部署的服务，如写作的 Affine、代码服务 Gitea、备忘录记录服务 memos 记录自己的碎碎念。自部署这些服务的时候通常会涉及一些资源的存储，比如 Affine 中上传的图片资源、Gitea 的 package 制品、memos 中上传的图片等都需要消耗自身的存储空间。而我部署的平台是 PVE 的 Docker LXD 容器，这个容器里面使用 Docker 部署了一堆服务，存储已经扩了一遍又一遍了，然而主机上的存储也见底了。

正好家里还有一台绿联的 NAS，里面有一个闲置的存储池，正好用来建一个 S3 存储给以上这些服务使用。这样一方面可以在同一个地方管理上传的对象，另一方面也可以利用存储池 Raid 做一些备份。

2. 部署 Rustfs

要说开源 S3 实现就不得不提大名鼎鼎的 Minio 了，然而其因为商业化已经停止了仓库的维护。况且我的 NAS 也仅是 4C8G 的配置，所以资源能省则省，基于 Rust 开发的 Rustfs 就是最好的选择——部署简单，资源占用低，性能还高，简直是居家旅行、自部署常备。

NAS 上的 Docker 不能命令行，只能图形界面操作，就略过部署过程了。

部署好了之后打开 console 端口 9001 即可进行存储桶操作。

2.1 使用 AWS CLI 测试访问

创建一个访问密钥，使用 AWS CLI 来测试访问。在 ~/.aws/credentials 中配置好访问密钥，~/.aws/config 中配置 endpoint 信息：

[default]
region=us-east-1
endpoint_url=http://192.168.5.103:9000

region 随便填一个值就可，测试访问：

➜ : aws s3 ls s3://
2026-04-22 00:58:25 affine-storage
2026-04-22 15:20:44 gitea-storage
2026-04-22 00:42:14 linkzz-bucket

3. 使用 Rustfs 存储数据

下面介绍使用 Rustfs 储存的服务。

3.1 Affine

内网 Affine 的搭建可以看这篇文章。Affine 的存储引擎默认是本地文件系统，在 admin 页面可以更换为 S3 存储。

可以分两个存储桶，一个存上传的媒体文件，一个存用户头像。内网使用用户就一个，单独建一个桶来存媒体文件就好了。

文件已然美美的上传了。

3.2 Gitea

Gitea 的代码不支持 S3 存储，但好在自己写的代码也不会太占空间。但是如果用到 Gitea 的 Package 上传一些 Docker 镜像或者是存储流水线存储的制品，这些可是很占空间的。好在这些都是支持 S3 存储的。这里要赞扬一波 Gitea，公司内部的代码库也是我搭的 Gitea，虽然脱胎于 Gogs，但在保持 Gogs 轻量级体验的同时引入了很多 GitHub 相关的功能，如完全兼容 GitHub Actions 的流水线、同样的 Package 系统（支持 Docker 镜像、Java Nexus Maven 仓库、NPM Registry 等），常见的语言依赖仓库都支持，省了很多自建的烦恼，使用起来也是极其丝滑。一个开源的产品能做到这样真的没得说。

Gitea 需要在配置文件中开启 S3 存储，加入下面的配置项重启即可：

[storage]
STORAGE_TYPE = minio
MINIO_ENDPOINT = 192.168.5.103:9000
MINIO_ACCESS_KEY_ID = YOUR_AK
MINIO_SECRET_ACCESS_KEY = YOUR_SK
MINIO_BUCKET = gitea-storage
MINIO_LOCATION = us-east-1

构建一个 Docker 镜像上传试试看：

gitea-storage 桶里面也有值了，只是为啥这么小，压缩率这么大的吗？后续再研究一下。

3.3 Memos

Memos 也是原生支持 S3 存储，后台配置一下即可：

测试一下：

看下桶里面有没有数据：

没问题！搞定！

4. 总结

终于是将一些自部署服务的媒体文件都搜集起来了。使用 S3 来集中存储自部署的这些文件，以后部署在甲骨文上的一些服务也可以将存储迁移到 S3 桶里面。后续再做一个定期将服务数据打包上传 S3，再也不怕哪天甲骨文突然被收回了。

私有知识库和笔记工具 Affine 搭建, 修复导入 Markdown 图片丢失的问题

Wed, 12 Nov 2025 00:00:00 +0000

私有知识库和笔记工具 Affine 搭建, 修复导入 Markdown 图片丢失的问题

前言

一直以来我使用 Obsidian 作为我的知识库管理和编辑工具，配合自建的图床和 Nextcloud 的同步，我几乎可以在任何地方随意维护我的知识库，后面因为 Obsidian 的 Vim 模式用起来不顺手，在中文之间移动有卡顿的感觉，所以索性编辑器直接就用了 Vim ，但我一直苦恼一个问题，就是我的知识库一直以 Markdown 源文件的方式在 Nextcloud 的同步下，我虽然可以随时打开 Obsidian 查看，但是在移动端查看不方便，以及每次想查询的时候还得打开客户端，我本人是很不喜欢客户端的，我希望能在 web 上就可以查看，当然 Nextcloud 也能在网页端查看渲染的 Markdown 文件，但是效果也差强人意，正好刷 Koala 聊编程的时候看到了 Affine，其主打的 Notion 替代品的概念吸引了我，虽然我也用 Notion，但用的并不多，而且 Notion 无法迁移我的本地知识库，导入的 Markdown 格式各种问题，抱着试试看的心态部署了一下，虽说官方提供了完整的 docker-compose配置文件，但实际配置下来还是遇到了一些问题，在此权当记录一下。

安装 affine 服务端

Docker compose 安装服务端

还是使用 dokcer compose部署，下载最新版本 docker-compose.yaml文件。

wget -O docker-compose.yml https://github.com/toeverything/affine/releases/latest/download/docker-compose.yml

下载配置模板修改配置

wget -O .env https://github.com/toeverything/affine/releases/latest/download/default.env.example

下面是我的配置

# 数据库挂载目录
DB_DATA_LOCATION=./postgres
# 上传的附件目录
UPLOAD_LOCATION=/mnt/media/affine
# 配置文件目录
CONFIG_LOCATION=./config
# 数据库配置
DB_USERNAME=affine
DB_PASSWORD=****
DB_DATABASE=affine
# select a revision to deploy, available values: stable, beta, canary
# 部署的版本：稳定版
AFFINE_REVISION=stable

# set the host for the server for outgoing links
# AFFINE_SERVER_HTTPS=true
# AFFINE_SERVER_HOST=affine.yourdomain.com
# or
# 这里是我的自定义的内网域名，如果放到公网改成你自己的域名，如果内网IP访问则去掉这行
AFFINE_SERVER_EXTERNAL_URL=https://wiki.linkzz.hm

运行

docker compose up -d

正常运行之后打开 http://{youip}:3010 进行管理员配置

反向代理

内网部署服务众多，我不想记忆每个服务的端口，所以我选择使用内网域名来进行反代，下面是 Nginx 反代的配置：

map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}
upstream wiki-server {
    server 192.168.5.128:3010;
}
server {
    listen      443 ssl;
    server_name wiki.linkzz.hm;
    ssl_certificate     ssl/linkzz.hm/_wildcard.linkzz.hm.pem;
    ssl_certificate_key  ssl/linkzz.hm/_wildcard.linkzz.hm-key.pem;

    ssl_session_timeout  5m;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers on;

    location / {
            proxy_pass                                           http://wiki-server;
            proxy_set_header Host                                $host:$server_port;
            proxy_set_header X-Real-IP                           $remote_addr;
            proxy_set_header X-Forwarded-For                     $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto                   https;
            proxy_set_header Upgrade                             $http_upgrade;
            proxy_set_header Connection                          $connection_upgrade;
            proxy_cache_bypass                                   $http_upgrade;
            proxy_http_version                                   1.1;
    }

    error_page 404 /404.html;
        location = /40x.html {
    }

    error_page 500 502 503 504 /50x.html;
        location = /50x.html {
    }
}

server {
   listen 80;
   server_name wiki.linkzz.hm;
   rewrite ^(.*)$ https://${server_name}$1 permanent;
}

解决导入时图片跨域问题

我部署的版本是 0.25.0 这个版本导入 Markdown 文件时其他格式都能很好保留，唯独图片存在跨域的问题，看了下控制台，Markdown 中的外链图片会通过官方的 Cloudflare worker 处理，这个worker 默认只处理官方host 的 Referer, 即 https://app.affine.pro/ ，而我们部署的版本浏览器会自动加上这个域名的Referer，所以图片导入是无法使用的。

部署自己的图片处理 worker

好在官方已经开源了这个 worker

GitHub - toeverything/affine-workers

我们可以自己部署自己的版本来解决这个问题，Fork 一下官方源码，修改以下地方

modified packages/utils/src/headers.ts
@@ -5,6 +5,7 @@ const ALLOW_ORIGIN: OriginRule[] = [
   'https://app.affine.pro',
   'https://insider.affine.pro',
   'https://affine.fail',
+  'https://wiki.linkzz.hm',
   'https://try-blocksuite.vercel.app',
   /https?:\/\/localhost(:\d+)/,
   /https:\/\/.*?-toeverything\.vercel\.app$/,
modified packages/worker/src/index.ts
@@ -2,7 +2,7 @@ import { DomainRouterBuilder, domainRoutersHandler, type Env } from '@affine/uti

 import { AFFiNEWorker } from './affine.js';

-const WORKER_DOMAIN = 'affine-worker.toeverything.workers.dev';
# 这个地址需要改为你的worker 访问地址
+const WORKER_DOMAIN = 'affine-worker.***.workers.dev';

 const affine = AFFiNEWorker();

modified packages/worker/wrangler.toml
@@ -4,5 +4,19 @@ compatibility_date = "2023-11-21"
 workers_dev = true
 minify = true

-[limits]
-cpu_ms = 500
+# [limits]
+# cpu_ms = 500
+[observability]
+enabled = false
+head_sampling_rate = 1
+
+[observability.logs]
+enabled = true
+head_sampling_rate = 1
+persist = true
+invocation_logs = true
+
+[observability.traces]
+enabled = false
+persist = true
+head_sampling_rate = 1

observability 相关的配置是记录worker日志的，可以去掉

使用 wrangler或者在 Cloudflare 控制台关联仓库部署一下，下面是 wrangler 的部署步骤：

安装 wrangler

npm install -g wrangler

安装 pnpm

 npm install -g pnpm

安装依赖

pnpm install

登录授权 wrangler

wrangler login

部署 worker

pnpm run deploy

应用自己的worker

目前使用的这个版本 worker 的地址是硬编码在前端的，无法使用配置项替换，改官方源码还要编译构建，只能自己改下镜像替换一下制品，目前 0.25.0使用这个方法是可行的。

创建 Dockerfile 文件，下面的地址需要替换为你部署好的 worker 访问地址。

FROM ghcr.io/toeverything/affine:${AFFINE_REVISION:-stable}

RUN sed -i 's|https://affine-worker.toeverything.workers.dev|https://affine-worker.***.workers.dev|g' /app/static/js/index.*.js

然后修改 docker-compose.yml 文件

name: affine
services:
    affine:
        # 使用 Local Dockerfile 构建镜像
        #image: ghcr.io/toeverything/affine:${AFFINE_REVISION:-stable}
        build: .
        container_name: affine_server

最后重启之后运行容器

docker compose down && docker compose up -d --build

没问题的话就可以试试效果了

以上是我的博客的一篇文章导入的效果，可以看到他成功下载了我图床里面的图片并导入到了内置的存储之中。

结语

目前使用下来，Affine 还是比较丝滑的，目前这个还不是完整版的 Affine，因为AI 功能尚未配置，不过用作个人知识库倒是足够了，我先深度使用一段时间来看看，后续等 AI 功能稳定了再考虑配置。