Skip to content

服务端安装与配置 ​

本章导读 ​

deploy-server 是单二进制交付的自托管 CI/CD 服务端:HTTP API、WebSocket 实时日志、 执行引擎、内嵌前端与 SQLite 全部打进一个可执行文件,解压即用,零外部依赖。 本章覆盖从拿到二进制到生产可用的完整路径:启动配置、数据目录、用户与权限、 凭据管理、两种部署形态(systemd / Docker)、升级备份,以及从源码构建。

如果你只想先跑起来,请先阅读安装服务端与 初始化与登录,再回到本章做生产化配置。

页面目录 ​

页面内容
01 启动参数与配置文件命令行参数、YAML 配置、环境变量、优先级与热生效项
02 数据目录与日志存储目录结构、密钥文件、日志落盘与保留策略
03 用户、角色与可见性bootstrap 初始化、admin/user 权限矩阵、登录锁定
04 凭据与 API TokenGit 凭据、加密存储、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, 更多加固建议见安全加固。

相关章节 ​