主题
服务端安装与配置
本章导读
deploy-server 是单二进制交付的自托管 CI/CD 服务端:HTTP API、WebSocket 实时日志、 执行引擎、内嵌前端与 SQLite 全部打进一个可执行文件,解压即用,零外部依赖。 本章覆盖从拿到二进制到生产可用的完整路径:启动配置、数据目录、用户与权限、 凭据管理、两种部署形态(systemd / Docker)、升级备份,以及从源码构建。
如果你只想先跑起来,请先阅读安装服务端与 初始化与登录,再回到本章做生产化配置。
页面目录
| 页面 | 内容 |
|---|---|
| 01 启动参数与配置文件 | 命令行参数、YAML 配置、环境变量、优先级与热生效项 |
| 02 数据目录与日志存储 | 目录结构、密钥文件、日志落盘与保留策略 |
| 03 用户、角色与可见性 | bootstrap 初始化、admin/user 权限矩阵、登录锁定 |
| 04 凭据与 API Token | Git 凭据、加密存储、SSH 公钥、dk_ 令牌 |
| 05 systemd 部署与反向代理 | unit 安装、回环绑定、Nginx WebSocket 与 HTTPS |
| 06 Docker 部署 | 镜像构建、数据卷挂载、容器内执行的边界 |
| 07 升级、备份与恢复 | 停服备份、替换二进制、恢复与磁盘清理 |
| 08 从源码构建 | 前端到后端的构建顺序、Windows/Linux 工具链 |
运行形态怎么选
- 直接部署宿主机应用(推荐 systemd):项目脚本要操作宿主机上的 Nginx、systemd 服务、宿主机目录时,选这种形态。命令以服务账号 (仓库 unit 默认 root)的权限在宿主机上执行,没有隔离层。见 05。
- 容器化运行(Docker):适合构建产物本身交付为容器、或希望服务端 自身环境可复现的场景。注意项目命令在容器内执行:访问宿主机目录 需要显式挂载,容器内的 systemctl 管不了宿主机服务。见 06。
- 对外访问一律走反向代理 + HTTPS:本服务本质是「远程命令执行」, 默认只监听
127.0.0.1:10055是有意设计。公网暴露必须经过 Nginx 等 反代并启用 HTTPS,不要直接把端口裸奔到公网。配置见 05, 更多加固建议见安全加固。
相关章节
- CLI 服务器管理:用 deploy-cli 配置服务器地址与令牌。
- 环境变量与 Secret:项目级加密变量,与本章的 secret.key 同源。
- 日志与实时跟随:运行日志的查看与 WebSocket 补齐机制。
- 系统设置:运行时可热改的设置项。
- 认证与通用约定:API 鉴权方式与响应结构。