Skip to content

安全加固 ​

deploy 服务端拥有「以服务端账号执行任意 Shell」的能力——它的暴露面等同于一个远程执行入口。 本页按暴露面、凭据、权限、数据四层给出加固清单。

网络暴露面 ​

  • 绑定回环:-listen 127.0.0.1:10055(systemd unit 默认 0.0.0.0,需 sed 改回),经反代或 SSH 隧道访问。
  • HTTPS 反代:Nginx/OpenResty 转发 WebSocket 升级头、proxy_buffering off、proxy_read_timeout 足够长;证书就绪后再开放公网。
  • 不直接暴露 10055:安全组/防火墙只放 80/443(及业务端口)。
  • Hook 端点免登录:/api/v1/hooks 以令牌为全部凭据,必须 HTTPS;URL 形式令牌注意访问日志脱敏。
  • 内网穿透场景(frp 等):穿透隧道本身也要鉴权与最小端口映射,只映射必需端口。

凭据与密钥 ​

对象要求
登录 JWT默认 168h 过期;仅人工会话使用
API Token dk_自动化专用;一人/一系统一令牌,泄露即撤销;CLI 配置 0600
Hook Token hk_只存哈希、明文仅一次;最小分发;创建时设有效期(expiresInDays);仅重置/删除;限流 60/min 默认
Git 凭据加密存储;用部署密钥/只读 token,不用个人账号密码;带口令 SSH key 不支持
data/secret.key与数据库一起备份;丢失无法恢复 Secret 与凭据;权限 0600
data/jwt.key同上备份;泄露可伪造会话
  • 密码/密钥不进 Git、不进项目脚本明文、不进聊天与工单;用 Secret 变量或服务端受限文件。
  • 中间件生成的随机密码会在安装日志出现一次:改自管密码、限制日志权限。
  • CLI 侧 ~/.deploy/config.yaml 按服务器凭据保护;server list/whoami 输出已打码,仅 config get token 明文。

权限与可见性 ​

  • 角色:admin 管用户/凭据/中间件/系统设置;user 管自己的项目/任务。
  • 编辑与执行仅 owner 或 admin;visibility allReadable 只给他人只读,ownerOnly 完全不可见——多租户/跨团队选后者。
  • 开放注册为预留项(当前无自助注册接口、设置页只读):账号一律 admin 创建;建用户/重置密码会置首次改密标记。
  • 登录失败锁定:同名 5 次失败锁 10 分钟(内存态,重启清零)——不要依赖它做长期防爆破,反代层限速更可靠。
  • 服务端执行账号即脚本权限:仓库 unit 以 root 运行便于 systemctl;若改普通账号,注意 NoNewPrivileges=true 会阻止 sudo 提权。

中间件与工具链默认值 ​

  • 数据库/Redis 默认端口映射宿主机、面向内网便利;公网前改绑定/防火墙/强密码。
  • Elasticsearch 默认关闭安全认证:公网必须开认证或限制来源 IP。
  • 容器数据卷随 remove 保留:删卷是独立破坏性操作,需显式授权。
  • 工具链安装脚本以 root 写系统目录:仅 admin 可触发,参数 URL 指向可信镜像源。

日志与审计 ​

  • 日志含命令输出与 Secret 掩码;dataDir 建议 0750,反代不泄露日志路径。
  • 保留期 logRetentionDays 与单运行上限 logMaxBytes 按合规要求调整。
  • 发布审计用 runs list(触发者/时间/终态)+ 日志内 GIT_COMMIT;失败运行不要删项目清痕迹。

备份与恢复 ​

停服 → 打包整个 dataDir(含 deploy.db、secret.key、jwt.key、logs)→ 替换二进制 → 启动。 工作区如需保留单独备份。恢复时 secret.key 必须与数据库同批,否则 Secret 解密失败。 详见 升级、备份与恢复。

延伸阅读 ​