1Panel 与其它面板部署（含群晖 / Unraid）

1Panel 与宝塔的思路类似，但对 Docker 原生支持更彻底：可以直接把交付包里的 docker-compose.yml 当「编排」导入，用面板管理容器的启停、日志与升级。

路线 A：用编排创建（推荐）

1. 1Panel →「容器」→「编排」→「创建编排」，名称填 yaka；
2. 把交付包里 docker-compose.yml 的内容整段粘贴进去；
3. 在「环境变量」里补齐 .env 的必填项（PUBLIC_BASE_URL、PG_PASSWORD、 DB_DSN、SESSION_SECRET）—— 编排方式下不读 .env 文件， 必须在这里显式给；
4. 创建并启动，然后到「容器」页确认 postgres、yaka-ext 健康。

编排方式少了 .env 的密钥自动生成，口令要自己生成： openssl rand -base64 24。图省事就用路线 B。

路线 B：终端跑一键安装

mkdir -p /opt/yaka && cd /opt/yaka
# 也可以在「文件管理 → 远程下载」里把这个直链拉到 /opt/yaka
#   https://yaka-dist.tos-cn-beijing.volces.com/releases/latest/yaka-instance.tar.gz
curl -fsSLO https://yaka-dist.tos-cn-beijing.volces.com/releases/latest/yaka-instance.tar.gz
tar -xzf yaka-instance.tar.gz && cd yaka-instance-*
bash install.sh

装完同样用 curl -fsS http://127.0.0.1:8088/healthz 验收，再到 1Panel 的 「网站」里建反向代理并申请证书。

其它面板（aaPanel / 小皮 / 群晖 / Unraid）

• 只要有 Docker + Compose v2：都能走上面两条路。核心就三件事 —— 容器跑起来、数据卷持久化、外层反代带对头。
• 群晖 / Unraid：用「项目 / Compose」功能导入 docker-compose.yml， 把 pg-data 卷映射到 NAS 上的固定路径，方便做快照。
• 不要用「单容器」模式：这套系统是四容器拓扑，单独 run 一个容器起不来。

踩坑清单