Deployment and Configuration

安装与配置

新建业务站点

在新的部署目录放置当前发布的 Compose 文件，DNS 指向本机，确保标准端口可达。 HTTPS 的 .env 最少只需：

TLS_ENABLED=true
SERVER_NAME=media.example.com

docker compose up -d --wait

默认拉取公开 main/latest Web/Nginx 镜像，SQLite，自动初始化持久密钥；不现场编译。 首次证书失败不会退到明文业务。无 .env 时仍支持本机 HTTP 启动。 已有数据不得套用空库初始化。更换 DB_TYPE、目录或域名不是数据迁移。

首次 Admin 密钥在本部署 Compose 目录读取，勿公开输出：

docker compose exec -T web cat /run/frontiercloud-secrets/admin_key

运维包与全局 foc

不取完整源码可用发布的 scripts/get-fc.sh 提取运维包，在包内运行 ./fc doctor 和 ./fc install master / ./fc install storage。包内二进制叫 fc，全局命令叫 foc。

默认业务和存储 Compose 必须安装全局 foc，安装成功后才执行业务初始化。 安装器使用独立固定的已发布镜像，执行后退出。首次运行 foc 核验并登记当前部署； 已有不同版本的受管理工具会被保留，普通升级按需自更新。旧 Compose 部署仍可用独立 compose.foc.yaml 安装器接入有合法版本凭据的部署。 不要复制一个宿主机服务、进入 certificate-agent 或覆盖 Bash 内建 fc。 具体初装变量和碰撞拒绝规则见完整手册。

存储节点

使用 .env.storage.example 和 docker-compose.storage.yaml，不叠加业务 Compose。 Direct 为 HTTPS 443；Relay 显式选 relay、默认通信端口 8443，两者 HTTP-01 均临时使用 80。 存储使用内嵌 SQLite，没有独立站点、Redis、MySQL、Nginx 或播放器。 HTTPS 就绪后取得五分钟一次性配对包，在 Master Admin 导入并配置容量。

已有节点必须保留身份、原数据库、密钥、关系和媒体挂载；不能删除后重新配对来冒充升级。 详见存储部署与交接。