登录与安全 — Guide 文档

Guide 支持本实例独立应急密码和可选 GitHub OAuth。没有官方统一密码、万能应急密码或邮箱恢复流程。

应急密码

首次安装时会生成本实例的随机应急密码，并在终端输出。请妥善保存，正常重启不会重新生成密码。

第一次进入 /admin/ 后，在“安全”页面改为自己的密码，至少 12 位。修改后，其他浏览器的旧登录会失效，当前浏览器保持登录。密码不会自动过期，也不会强制首次修改，请主动完成。

首次安装或终端重置的密码输出可能留在终端、systemd journal 等日志中。在更换前把这些记录视作敏感数据。

先用应急密码进入后台，在自己的 GitHub 账号创建 OAuth App，把 Client ID、Client Secret 和允许的用户名填入“安全”页面。使用自己的 HTTPS 域名，回调格式如下：

https://你的域名/api/auth/github/callback

用户名白名单以逗号分隔；空白名单拒绝所有 GitHub 用户。配置你自己的 OAuth 凭据，Guide 不提供共享 secret。数据库和备份含认证配置，不能公开。

通过有数据库读写权限的服务器终端执行。先确认数据库真实存在，使用正在运行实例的实际路径；不能创建新空库“恢复”旧账号。

/opt/guide/guide-hub --db /var/lib/guide/guide.db --reset-password

这是标准安装路径示例，自定义部署须替换程序和数据库的绝对路径，并以有读写权限的系统用户执行。命令输出新的随机密码，不接受明文新密码参数，也不启动 HTTP 服务；全部旧登录失效，但 GitHub OAuth 配置保留。登录后再设置自己的密码。

权限、systemd 与自建容器注意事项见官方账号恢复说明。不要把示例路径误用于另一个实例。

公网后台使用 HTTPS，不把明文后台直接暴露到公网。保管数据库、备份、OAuth secret、Cookie 和初始化日志，使用合适的目录权限。升级不会为了接入 updater 自动重置账号。

发现漏洞时按公开安全报告规则私下报告，不把凭据或数据库上传到公开 Issue。