Skip to content

初始化与登录 ​

创建首个管理员 ​

系统没有预置账号或默认密码。浏览器打开服务端地址,未初始化时自动进入初始化页(/user/setup): 用户名至少 3 位、密码至少 8 位。等价 API 为 POST /api/v1/auth/bootstrap(见 API 参考)。

对外开放实例前务必先完成初始化,否则任何人都能创建管理员。

创建 API Token ​

登录后进入「个人设置 → API Token」创建一个令牌(dk_ 前缀)。 自动化与 CLI 推荐使用 API Token 而非登录 JWT:JWT 默认 168 小时过期,无人值守流程会在某刻突然 401。

把服务器写进 CLI ​

bash
deploy server add local -a http://127.0.0.1:10055 -t dk_xxxxxxxx -u admin
deploy whoami

server add 默认把新服务器设为当前默认;多台服务器时用 --no-set-current 保持现状,之后以 --server <名字> 临时指定。 配置落在 ~/.deploy/config.yaml(目录 0700、文件 0600),详见 安装与服务器管理。

也可以用登录命令一步完成(会先校验令牌再落盘):

bash
deploy login -a http://127.0.0.1:10055 --token dk_xxxxxxxx --name local

环境自检 ​

bash
deploy doctor

检查服务端 OS/目录可写性/Shell 选择/常用工具探测/前端是否真构建(web.built)。 缺工具时可在网页「环境自检」页一键安装工具链,见 工具链安装。

设置外部地址 ​

在「系统设置 → 服务端外部地址」填写用户实际访问的 URL(反代域名等)。该设置无需重启,会以 DEPLOY_SERVER_URL 注入项目脚本。

下一步 ​

部署第一个项目。