关于 OpenFic 的简介，请访问原项目链接。本篇仅记录我在 VPS 上部署自托管 OpenFic 的全过程。

我的部署流程大致分为两个阶段：

第一阶段：直接部署官方 repo
第二阶段：部署自己 fork 的版本（添加了一些新功能支持）

1. 官方版本部署#

由于我的 VPS 上先前已经部署了 Dcomost，所以对于 OpenFic，我的部署方案结构大致为：

1
                         VPS
2
                          │
3
                    Docker Caddy
4
                   :80 / :443
5
                    /        \
6
                   /          \
7
 story.example.com             fiction.example.com
8
         │                            │
9
         ▼                            ▼
10
      docmost:3000                 openfic:8000
11
         │
12
     ┌───┴────┐
13
     ▼        ▼
14
 PostgreSQL  Redis

这里简要介绍一下 Docker Caddy：

由于先前的 Docmost 已经引入了一个 Caddy，所以这里就直接复用了先前的。

1.1 前期工作#

1.1.1 新增子域名#

在此之前，我已经有了一个 Dcomost 的子域名：

1
A    story      1.2.3.4

这个域名我们保留不动，然后再添加：

1
A    fiction    1.2.3.4

于是：

1
story.example.com   → 1.2.3.4
2
fiction.example.com → 1.2.3.4

然后我们可以检查：

1
getent ahostsv4 fiction.example.com

这条指令应该返回我们的 VPS 公网 IP。

而关于公网端口的开放，下列端口

已经足够。

1.1.2 建立 Caddy 和 OpenFic 的共享 Docker 网络#

执行：

1
sudo docker network create reverse_proxy

确认：

1
sudo docker network ls

我们应该看到：

1
reverse_proxy

1.2 修改现有 Docmost Compose#

由于我先前已经部署了 Docmost，所以我先进入：

1
cd ~/docmost

编辑：

1
nano docker-compose.yml

我当时的 Caddy 大概是：

1
services:
2
  caddy:
3
    image: caddy:2
4
    ports:
5
      - "80:80"
6
      - "443:443"
7
    volumes:
8
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
9
      - caddy_data:/data
10
      - caddy_config:/config
11
    depends_on:
12
      - docmost
13
    restart: unless-stopped

将其修改成：

1
services:
2
  caddy:
3
    image: caddy:2
4
    ports:
5
      - "80:80"
6
      - "443:443"
7
    volumes:
8
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
9
      - caddy_data:/data
10
      - caddy_config:/config
11
    depends_on:
12
      - docmost
13
    restart: unless-stopped
14
    networks:
15
      - default
16
      - reverse_proxy

这里的：

1
- default

非常重要，因为 Caddy 仍然需要访问：

1
docmost:3000

然后在这个 Compose 文件最底部，当时已经有：

1
volumes:
2
  docmost:
3
  db_data:
4
  redis_data:
5
  caddy_data:
6
  caddy_config:

在它后面添加：

1
networks:
2
  reverse_proxy:
3
    external: true

所以结尾应该类似：

1
volumes:
2
  docmost:
3
  db_data:
4
  redis_data:
5
  caddy_data:
6
  caddy_config:
7

8
networks:
9
  reverse_proxy:
10
    external: true

检查：

1
sudo docker compose config -q

没有输出就说明 YAML 基本正常。

1.3 让现有 Caddy 加入新网络#

应用修改：

1
sudo docker compose up -d caddy

检查：

1
sudo docker compose ps

应该仍然：

1
caddy     Up
2
docmost   Up
3
db        Up
4
redis     Up

再确认 Docmost 没受影响：

1
curl -fsS https://story.example.com/api/health

正常的话说明我们目前的修改成功。

1.4 生成 OpenFic 密码#

和 Docmost 类似，我也创建了一个 ~/openfic 目录，与 ~/docmost 平级，我的目录结构类似：

1
~
2
├── docmost/
3
│   ├── Caddyfile
4
│   └── docker-compose.yml
5
│
6
└── openfic/
7
    ├── .env
8
    ├── docker-compose.yml
9
    └── data/

接着我们执行：

1
openssl rand -base64 36

这一步生成的就是一个随机的强密码，当然你也可以用自己的，我们复制输出结果。

然后：

1
vi ~/openfic/.env

填写：

1
OPENFIC_AUTH_PASSWORD=这里换成刚生成的密码

例如：

1
OPENFIC_AUTH_PASSWORD=VJKy2pFTZ7A9VdgJmF9r2CVg8SLwKUZmP9C8X7fhdnL7F9hJ

保存后：

1
chmod 600 ~/openfic/.env

如果不配置这个变量，应用级密码保护就是关闭状态。也就是说，任何人访问你的域名都能进入你的系统。

1.5 创建 OpenFic Compose#

执行：

1
cd ~/openfic
2
vi docker-compose.yml

写入：

1
services:
2
  openfic:
3
    image: ghcr.io/syrizelink/openfic:latest
4
    container_name: openfic
5
    restart: unless-stopped
6

7
    environment:
8
      OPENFIC_DATA_DIR: /data
9
      OPENFIC_AUTH_PASSWORD: "${OPENFIC_AUTH_PASSWORD}"
10

11
      # Caddy 位于另一个 Docker 网络地址，
12
      # 允许 Uvicorn 接受反向代理提供的 HTTPS 信息。
13
      FORWARDED_ALLOW_IPS: "*"
14

15
    volumes:
16
      - ./data:/data
17

18
    networks:
19
      - reverse_proxy
20

21
networks:
22
  reverse_proxy:
23
    external: true

我们让 OpenFic 官方镜像本身在容器内监听 0.0.0.0:8000，同时把 /data 设置成其持久化数据目录。

检查：

1
sudo docker compose config -q

1.6 启动 OpenFic 并验证 Caddy 能不能找到 OpenFic#

首先：

1
cd ~/openfic
2
sudo docker compose pull

然后：

1
sudo docker compose up -d

检查：

1
sudo docker compose ps

应该类似：

1
NAME      IMAGE                                   STATUS
2
openfic   ghcr.io/syrizelink/openfic:latest      Up

查看日志：

1
sudo docker compose logs --tail=100 openfic

如果想实时查看：

1
sudo docker compose logs -f openfic

退出日志查看：

1
Ctrl+C

因为现在 OpenFic没有映射宿主机端口，所以我们不能再：

1
curl 127.0.0.1:8000

可以直接从 Caddy 容器测试 Docker 网络：

1
cd ~/docmost
2
sudo docker compose exec caddy \
3
  wget -qO- http://openfic:8000/api/v1/health

正常的话应该看到类似：

1
{"status":"healthy","version":"..."}

如果成功，说明：

1
Caddy → OpenFic

这条链路已经打通。

1.7 修改现有的 Caddyfile#

现在回到：

1
cd ~/docmost
2
vi Caddyfile

我当时应该类似：

1
story.example.com {
2
    reverse_proxy docmost:3000
3
}

这是我原来的部署方式。

然后我将其改成：

1
story.example.com {
2
    reverse_proxy docmost:3000
3
}
4

5
fiction.example.com {
6
    reverse_proxy openfic:8000
7
}

Info

将两个域名替换成你自己的真实域名。

1.8 检查并重新加载 Caddy#

先验证：

1
cd ~/docmost
2

3
sudo docker compose exec caddy \
4
  caddy validate \
5
  --config /etc/caddy/Caddyfile

如果看到类似：

1
Valid configuration

重新加载：

1
sudo docker compose exec caddy \
2
  caddy reload \
3
  --config /etc/caddy/Caddyfile

然后我们就可以访问 OpenFic，用浏览器打开：

1
https://fiction.example.com

Caddy 会负责：

1
DNS
2
 ↓
3
VPS :443
4
 ↓
5
Caddy
6
 ↓
7
openfic:8000

并自动为新的：

1
fiction.example.com

申请 HTTPS 证书。

然后 OpenFic 会要求输入：

1
OPENFIC_AUTH_PASSWORD

设置的密码。

它验证成功后会生成 HTTP-only Cookie；通过 HTTPS 使用时会设置 Secure Cookie。

1.8.1 如果出现错误#

这一步我遇到了一个问题，就是浏览器访问我的域名显示：

1
此网站无法提供安全连接
2
【我的域名】发送的响应无效。
3

4
ERR_SSL_PROTOCOL_ERROR

如果遇到了这个问题，可以按下面步骤排查：

1
# 1. 原来的 Docmost 是否正常
2
curl -I https://story.你的域名
3

4
# 2. 新域名解析到了哪里
5
getent ahostsv4 fiction.你的域名
6
getent ahostsv6 fiction.你的域名
7

8
# 3. 查看实际 Caddyfile
9
cd ~/docmost
10
cat Caddyfile
11

12
# 4. 验证并重新加载
13
sudo docker compose exec caddy \
14
  caddy validate --config /etc/caddy/Caddyfile
15

16
sudo docker compose exec caddy \
17
  caddy reload --config /etc/caddy/Caddyfile
18

19
# 5. 看证书申请日志
20
sudo docker compose logs --tail=200 caddy
21

22
# 6. 测试 HTTPS 握手
23
curl -vkI https://fiction.你的域名

你可以直接把上面指令的输出贴给 AI 让它帮你查问题。就我的经历来说，我问题的根因是：虽然在 ~/docmost/Caddyfile 里已经包含了新的 OpenFic 域名，但正在运行的 Caddy 容器实际加载的仍然是旧版 Caddyfile，也就是只包含 Docmost 的域名。

以我的 VPS 为例，我执行

1
cd ~/docmost
2

3
sudo docker compose exec caddy \
4
  cat /etc/caddy/Caddyfile

然后就发现只有

1
story.example.com {
2
    reverse_proxy docmost:3000
3
}

这里我们就需要重新创建 Caddy 容器：

1
cd ~/docmost
2

3
sudo docker compose up -d --force-recreate caddy

这样，新的容器就会重新执行：

1
宿主机 ./Caddyfile
2
        ↓
3
bind mount
4
        ↓
5
/etc/caddy/Caddyfile

1.9 以后两个项目的管理方式#

这是采用两个 Compose 项目最大的好处。

以我的 VPS 为例，如果要管理 Docmost：

1
cd ~/docmost
2

3
sudo docker compose ps
4
sudo docker compose logs -f
5
sudo docker compose restart docmost

管理 OpenFic：

1
cd ~/openfic
2

3
sudo docker compose ps
4
sudo docker compose logs -f
5
sudo docker compose restart openfic

更新 OpenFic：

1
cd ~/openfic
2

3
sudo docker compose pull
4
sudo docker compose up -d

这样，两边就互不影响。唯一共用的组件是就 Caddy，因此以后不用在 ~/openfic 中再创建 Caddy 容器。

2. Fork 版本部署#

2.1 记录已有配置#

我们先找到当前 OpenFic 容器，并记录现有配置。查看所有运行中的容器：

1
docker ps

或者只显示比较有用的信息：

1
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}\t{{.Ports}}'

我们应该能看到类似：

1
NAMES      IMAGE                                  STATUS       PORTS
2
openfic    ghcr.io/syrizelink/openfic:latest      Up 3 days    0.0.0.0:8000->8000/tcp

下面假设容器名就是：

1
openfic

如果你的实际容器名不同，把后面命令里的 openfic 替换掉。

先记录当前镜像：

1
docker inspect openfic --format 'Image={{.Config.Image}}'

再记录端口：

1
docker port openfic

再查看 restart policy：

1
docker inspect openfic --format 'RestartPolicy={{.HostConfig.RestartPolicy.Name}}'

最后查看环境变量：

1
docker inspect openfic --format '{{range .Config.Env}}{{println .}}{{end}}'

2.2 确认 `data` 有没有持久化挂载。#

如果是按照我的第一阶段部署方式，那么数据是持久化的。也就是说，以后更新版本，重新创建容器不会影响服务器端保存的数据。

不过我们还是可以检查一下，运行：

1
docker inspect openfic --format '{{range .Mounts}}{{printf "Type=%s Name=%s Source=%s Destination=%s\n" .Type .Name .Source .Destination}}{{end}}'

如果你看到类似：

1
Type=volume Name=openfic Source=/var/lib/docker/volumes/openfic/_data Destination=/data

那么就没啥问题，这表示：

1
容器 /data
2
     ↓
3
Docker volume: openfic
4
     ↓
5
/var/lib/docker/volumes/openfic/_data

换镜像、换容器都不会自动删除这个 volume。

如果看到：

1
Type=bind Name= Source=/home/user/openfic-data Destination=/data

也没问题。

这是 bind mount：

1
服务器 /home/user/openfic-data
2
                ↓
3
          容器 /data

同样是持久化的。

但如果这条命令完全没有出现 Destination=/data，就要停止后续部署操作，因为这意味着你的数据可能还在旧容器 writable layer 里，具体的迁移方法可以参考其他教程，或者就具体情况询问 AI.

你还可以专门只检查 /data：

1
docker inspect openfic --format '{{range .Mounts}}{{if eq .Destination "/data"}}Type={{.Type}} Name={{.Name}} Source={{.Source}}{{end}}{{end}}'

如果按照官方 README 的命令：

1
docker run -d -p 8000:8000 -v "openfic:/data" --name openfic ghcr.io/syrizelink/openfic:latest

部署，那么正常应该得到：

1
Type=volume Name=openfic ...

2.3 检查 `/data` 内的数据是否真的存在。#

运行：

1
docker exec openfic sh -lc 'ls -lah /data'

正常情况下应该能看到：

1
.key
2
openfic.db
3
checkpoints.db
4
...

也可以专门检查两个最关键文件：

1
docker exec openfic sh -lc '
2
test -s /data/openfic.db && echo "openfic.db: OK" || echo "openfic.db: MISSING";
3
test -s /data/.key && echo ".key: OK" || echo ".key: MISSING";
4
'

理想输出：

1
openfic.db: OK
2
.key: OK

其中 .key 很重要。OpenFic 启动时会优先读取数据目录里的 .key；如果没有，就会生成一个新的 key。已经保存在数据库里的 API Key 是用旧 key 加密的，因此如果你丢了 .key，旧的 Provider API Key 可能就无法正常解密。

2.4 从你的 GitHub 仓库拉取修改后的源码。#

clone 你的 fork：

1
git clone https://github.com/YOUR_USERNAME/OpenFic.git OpenFic-custom

然后：

1
cd OpenFic-custom

检查当前分支：

1
git branch --show-current

检查最后一次 commit：

1
git log -1 --oneline

检查工作目录：

1
git status

理想状态：

1
nothing to commit, working tree clean

如果你的代码以后已经 clone 过了，就不需要重新 clone：

1
cd ~/OpenFic-custom
2
git pull --ff-only

可以把 Docker 镜像 tag 直接和 Git commit 绑定：

1
TAG=$(git rev-parse --short HEAD)
2
echo "$TAG"

比如输出：

1
8f47e21

那么你的镜像就叫：

1
openfic-custom:8f47e21

这样将来出了问题，我们就可以知道服务器跑的到底是哪版源码。

2.5 在旧 OpenFic 继续运行的情况下，构建新镜像。#

这一步先不碰旧容器，运行：

1
docker build -t openfic-custom:$TAG .

想看更完整日志可以：

1
docker build --progress=plain -t openfic-custom:$TAG .

OpenFic 当前 Dockerfile 会先编译前端，然后安装 Python 后端依赖，再复制后端源码，最后把前端产物和 Python 后端一起放进镜像；最终应用仍然把运行数据目录定义为 /data。

有一个地方需要特别注意：Dockerfile 使用了：

1
uv sync --frozen

因此，如果你修改了：

1
backend/pyproject.toml

增加或者修改 Python 依赖，却没有同步提交：

1
backend/uv.lock

构建可能直接失败。

如果你只是改了 OpenFic 自己的 Python 源码，例如 Vertex adapter，而没有新增依赖，通常不会遇到这个问题。

构建完成后检查：

1
docker images | grep openfic-custom

应该出现：

1
openfic-custom    8f47e21    ...

2.6 先用空数据启动一次新镜像做 smoke test#

先启动临时测试容器：

1
docker run -d \
2
  --name openfic-smoke \
3
  -p 18000:8000 \
4
  openfic-custom:$TAG

检查：

1
docker ps | grep openfic-smoke

查看日志：

1
docker logs --tail 100 openfic-smoke

测试 HTTP：

1
curl -I http://127.0.0.1:18000/

或者：

1
curl -fsS http://127.0.0.1:18000/ >/dev/null && echo "OpenFic smoke test OK"

如果输出：

1
OpenFic smoke test OK

至少说明我们的镜像能正常启动。

然后删除测试容器：

1
docker stop openfic-smoke
2
docker rm openfic-smoke

2.7 正式切换前，停旧容器并完整备份 `/data`#

这一步可选，如果还没存什么重要数据，或者就自己一个人用，没有多用户的话，也可以直接跳。

创建备份目录：

1
BACKUP_DIR="$HOME/openfic-backup-$(date +%Y%m%d-%H%M%S)"
2
mkdir -p "$BACKUP_DIR/data"
3
echo "$BACKUP_DIR"

先停止 OpenFic：

1
docker stop openfic

然后从停止后的容器中复制整个 /data：

1
docker cp openfic:/data/. "$BACKUP_DIR/data/"

注意这里特意用了：

1
/data/.

而不是简单 /data/*，这样 .key 这样的隐藏文件也会被复制。

检查备份：

1
ls -lah "$BACKUP_DIR/data"

必须确认类似：

1
.key
2
openfic.db

都存在。

2.8 保留旧容器，不要直接删除，然后启动你的新镜像。#

先把旧容器改名，而不是删除：

1
OLD_CONTAINER="openfic-old-$(date +%Y%m%d-%H%M%S)"
2
docker rename openfic "$OLD_CONTAINER"
3
echo "$OLD_CONTAINER"

例如：

1
openfic-old-20260915-005230

由于我在第一阶段已经有了 ~/openfic/docker-compose.yml，所以启动新镜像这块儿就不手写 docker run 了，而是直接改 compose 文件用我自己的镜像。

我的原 compose 文件大致类似：

1
services:
2
  openfic:
3
    image: ghcr.io/syrizelink/openfic:latest
4
    container_name: openfic
5
    restart: unless-stopped
6

7
    environment:
8
      OPENFIC_DATA_DIR: /data
9
      OPENFIC_AUTH_PASSWORD: "${OPENFIC_AUTH_PASSWORD}"
10
      FORWARDED_ALLOW_IPS: "*"
11

12
    volumes:
13
      - ./data:/data
14

15
    networks:
16
      - reverse_proxy
17

18
networks:
19
  reverse_proxy:
20
    external: true

我们只需要把原本的 image: ghcr.io/syrizelink/openfic:latest 给改成我们刚刚构建的镜像就可以，比如：

1
image: openfic-custom:abc1234

改完之后，在正式启动前，先让 compose 帮你检查配置：

1
cd ~/openfic
2
sudo docker compose config

主要关注

1
image:
2
volumes:
3
networks:

是否正确。

2.9 如果新版本有问题，怎么快速回滚#

因为我们没有删除旧容器，所以回滚很简单。

先停止新版本：

1
docker stop openfic

删掉新容器：

1
docker rm openfic

把旧容器恢复名字：

1
docker rename "$OLD_CONTAINER" openfic

启动：

1
docker start openfic

检查：

1
docker logs --tail 100 openfic

这样就又回到了原来的镜像。

不过这里有一个例外：如果你的新代码包含了数据库 schema migration，并且新版本已经修改了 openfic.db，旧程序未必能兼容新版数据库。

如果你的 fork 没有修改数据库结构，一般风险就较低。

2.10 Google 应用默认凭证配置#

我的 fork 版本修改了原项目的 provider，使其支持 Google Vertex AI. 想要使用 Vertex，需要按照 Google 官方文档配置应用默认凭证，下面就记录我的配置过程。

首先，在服务器上以平时的 ubuntu 用户名运行官方命令：

1
bash <(curl -sSL https://storage.googleapis.com/cloud-samples-data/adc/setup_adc.sh)

它会帮助安装/运行 gcloud 并设置 ADC. 这里要注意的点就是建议不要用 sudo 执行，否则 ADC 有可能最终落在 root 的 home，而不是我们用户名所在的目录。

完成认证后确认文件存在：

1
ls -lah ~/.config/gcloud/application_default_credentials.json

然后把我们的 ~/openfic/docker-compose.yml 文件改成类似：

1
services:
2
  openfic:
3
    image: openfic-custom:124921b
4
    container_name: openfic
5
    restart: unless-stopped
6

7
    environment:
8
      OPENFIC_DATA_DIR: /data
9
      OPENFIC_AUTH_PASSWORD: "${OPENFIC_AUTH_PASSWORD}"
10
      FORWARDED_ALLOW_IPS: "*"
11

12
    # 这行
13
      GOOGLE_APPLICATION_CREDENTIALS: /run/secrets/gcp/application_default_credentials.json
14

15
    volumes:
16
      - ./data:/data
17

18
    # 还有这行
19
      - /home/ubuntu/.config/gcloud/application_default_credentials.json:/run/secrets/gcp/application_default_credentials.json:ro
20

21
    networks:
22
      - reverse_proxy
23

24
networks:
25
  reverse_proxy:
26
    external: true

接着我们重新创建 OpenFic 容器：

1
cd ~/openfic
2
sudo docker compose up -d

检查：

1
sudo docker ps --filter name=openfic

不要先测试 Vertex，先检查文件：

1
sudo docker exec openfic sh -lc '
2
ls -l /run/secrets/gcp/application_default_credentials.json
3
'

应该能看到类似：

1
-rw------- ... /run/secrets/gcp/application_default_credentials.json

然后确认环境变量：

1
sudo docker exec openfic sh -lc '
2
echo "$GOOGLE_APPLICATION_CREDENTIALS"
3
'

应该输出：

1
/run/secrets/gcp/application_default_credentials.json

再做一个存在性测试：

1
sudo docker exec openfic sh -lc '
2
test -r "$GOOGLE_APPLICATION_CREDENTIALS" \
3
  && echo "ADC readable: OK" \
4
  || echo "ADC readable: FAILED"
5
'

应该得到：

1
ADC readable: OK

最后的最后，在浏览器里打开网页，测试 provider 连接与 model 连接是否正常，就大功告成！

音乐

音乐

1. 官方版本部署#

1.1 前期工作#

1.1.1 新增子域名#

1.1.2 建立 Caddy 和 OpenFic 的共享 Docker 网络#

1.2 修改现有 Docmost Compose#

1.3 让现有 Caddy 加入新网络#

1.4 生成 OpenFic 密码#

1.5 创建 OpenFic Compose#

1.6 启动 OpenFic 并验证 Caddy 能不能找到 OpenFic#

1.7 修改现有的 Caddyfile#

1.8 检查并重新加载 Caddy#

1.8.1 如果出现错误#

1.9 以后两个项目的管理方式#

2. Fork 版本部署#

2.1 记录已有配置#

2.2 确认 `data` 有没有持久化挂载。#

2.3 检查 `/data` 内的数据是否真的存在。#

2.4 从你的 GitHub 仓库拉取修改后的源码。#

2.5 在旧 OpenFic 继续运行的情况下，构建新镜像。#

2.6 先用空数据启动一次新镜像做 smoke test#

2.7 正式切换前，停旧容器并完整备份 `/data`#

2.8 保留旧容器，不要直接删除，然后启动你的新镜像。#

2.9 如果新版本有问题，怎么快速回滚#

2.10 Google 应用默认凭证配置#

文章分享

评论区

音乐

音乐

OpenFic 部署全过程

1. 官方版本部署#

1.1 前期工作#

1.1.1 新增子域名#

1.1.2 建立 Caddy 和 OpenFic 的共享 Docker 网络#

1.2 修改现有 Docmost Compose#

1.3 让现有 Caddy 加入新网络#

1.4 生成 OpenFic 密码#

1.5 创建 OpenFic Compose#

1.6 启动 OpenFic 并验证 Caddy 能不能找到 OpenFic#

1.7 修改现有的 Caddyfile#

1.8 检查并重新加载 Caddy#

1.8.1 如果出现错误#

1.9 以后两个项目的管理方式#

2. Fork 版本部署#

2.1 记录已有配置#

2.2 确认 data 有没有持久化挂载。#

2.3 检查 /data 内的数据是否真的存在。#

2.4 从你的 GitHub 仓库拉取修改后的源码。#

2.5 在旧 OpenFic 继续运行的情况下，构建新镜像。#

2.6 先用空数据启动一次新镜像做 smoke test#

2.7 正式切换前，停旧容器并完整备份 /data#

2.8 保留旧容器，不要直接删除，然后启动你的新镜像。#

2.9 如果新版本有问题，怎么快速回滚#

2.10 Google 应用默认凭证配置#

文章分享

评论区

音乐

2.2 确认 `data` 有没有持久化挂载。#

2.3 检查 `/data` 内的数据是否真的存在。#

2.7 正式切换前，停旧容器并完整备份 `/data`#