重置 Octop 账户密码
先看你属于哪一种情况,再打开对应小节。新密码至少 8 位,须同时包含字母和数字,且不能是常见弱口令(例如 password123、admin123、octop123)。
改密之后,~/octop-login.txt 和 Docker 的 credential.txt 仍是改密前的内容。请使用你刚设置的新密码。
在页面中修改
登录页面后:
打开头像菜单
点击右上角头像。
修改密码
点击 修改密码,输入当前密码和新密码。
同一接口也可以用 curl 调用,见 认证:修改密码。
管理员重置其他用户
能登录的管理员可以为其他用户设置新密码,只需提供新密码。调用方式见 用户与管理 API:重置密码。
管理员自己也进不去时,改用下一节,在安装 Octop 的机器上重置。
在本机重置
在安装了 Octop 的电脑上,用运行服务的同一系统账户执行。命令直接写入本地数据库,服务可以处于停止状态。命令行安装和桌面客户端读写同一份数据库:~/.octop/octop.db(Windows 为 %USERPROFILE%\.octop\octop.db)。
octop user passwd 只改密码。账号被验证器或通行密钥锁在外面时,用 octop user reset-mfa <用户名> 清掉这些因子,不会改密码。桌面端还可以用 ~/.octop/desktop-device.json 里的设备凭据续上过期会话,不必再打开登录页。
把 <用户名> 和 <密码> 换成真实值。用户名是位置参数;写成 --username 会报 Error: No such option '--username'。可以省略 --password,改为交互输入(输入时不回显)。--password 会留在 shell 历史里,共用电脑时优先交互输入。不知道用户名时,先在同一环境列出用户。
先按安装方式选一节,再看你的系统:
Docker、飞牛OS 和腾讯云在这两节后面。
命令行安装
安装脚本或 pip 会把 octop 放进 PATH。命令是:
安装脚本会把包装命令放到 ~/.octop/bin,并写入 shell 配置。请新开一个终端,或执行 source ~/.zshrc / source ~/.bashrc。
终端仍找不到 octop 时,按下面的顺序用完整路径。你用另一个系统账户启动过 octop run 或 octop service 时,先切换到那个账户。数据在该账户的 ~/.octop/ 下。
例如:
完成后打开 http://127.0.0.1:8088(或你实际绑定的地址),用新密码登录。
桌面客户端
Docker
在宿主机执行。把容器名 octop 换成 docker ps 里的名字。镜像把 CLI 放在 /app/.venv/bin,并加入 PATH。
容器里找不到 octop 时:
首次部署的默认用户名是 admin,可用 OCTOP_ADMIN_USERNAME 覆盖。Compose 默认把宿主机 ~/.octop 挂到容器 /data/.octop,命令改的就是这份数据库。
首次密码说明见 Docker 部署:修改管理员密码。
飞牛OS
Docker 版(页面一般是 http://<NAS的IP>:8088)— 在 NAS 终端或 SSH 中执行。容器名以 docker ps 为准:
容器里找不到 octop 时:
本地版(页面一般是 http://<NAS的IP>:8089)— 安装时会把 CLI 链到 /usr/local/bin/octop(指向 octop-cli)。SSH 进入 NAS 后:
octop 不在 PATH 时,使用 /usr/local/bin/octop 或 /var/apps/octop-native/bin/octop-cli。
/var/apps/octop-native/bin/octop 是应用中心用来启动 Web 服务的程序。重置密码请用上面的 CLI,以免再占用 8089 端口。
用户名可在应用 设置 窗口里核对。数据目录里的 octop-login.txt 只保存安装时的引导密码。请以 octop-native 或 root 执行,这样数据文件的所有者保持不变。
安装与首次登录见 飞牛OS。
腾讯云
云服务器 CVM — 在实例详情页点击 登录,选择 免密连接(TAT)。终端会从 root 切到 agentuser。然后执行:
找不到 octop 时,使用该账户下的包装命令:
绝对路径一般是 /home/agentuser/.octop/bin/octop,其次是 /home/agentuser/.octop/venv/bin/octop。CVM 首次向导的一次性密码在 ~/octop-login.txt。完成设置后,使用你在向导里创建的账号。
轻量应用服务器 — SSH 登录实例,在运行 Octop 的账户下执行同样的命令。找不到 octop 时,先执行 echo $HOME,再调用 $HOME/.octop/bin/octop。页面地址以实例 应用管理 → Octop 控制台 为准。
开通步骤见 在腾讯云中使用。
机器能从网络访问时,安装时生成或向导里的密码只适合首次登录。重置完成后,用新密码再登录一次。
完整子命令见 渠道与定时任务:octop user。

