For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /guide/guides/reset-password.md.
  • 简体中文
  • 重置 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 user passwd <用户名> --password <密码>
    macOS / Linux
    Windows

    安装脚本会把包装命令放到 ~/.octop/bin,并写入 shell 配置。请新开一个终端,或执行 source ~/.zshrc / source ~/.bashrc。

    octop user list
    octop user passwd <用户名> --password <密码>

    终端仍找不到 octop 时,按下面的顺序用完整路径。你用另一个系统账户启动过 octop run 或 octop service 时,先切换到那个账户。数据在该账户的 ~/.octop/ 下。

    来源路径
    安装脚本包装~/.octop/bin/octop
    隔离环境~/.octop/venv/bin/octop
    自定义 OCTOP_HOME$OCTOP_HOME/bin/octop
    pip install octoppython3 -m octop

    例如:

    ~/.octop/bin/octop user passwd <用户名> --password <密码>

    完成后打开 http://127.0.0.1:8088(或你实际绑定的地址),用新密码登录。

    桌面客户端

    macOS
    Windows
    OCTOP_PY="/Applications/Octop.app/Contents/Resources/portable/runtime/bin/python3"
    OCTOP_LAUNCH="/Applications/Octop.app/Contents/Resources/portable/launch.py"
    
    "$OCTOP_PY" "$OCTOP_LAUNCH" user list
    "$OCTOP_PY" "$OCTOP_LAUNCH" user passwd <用户名> --password <新密码>

    Docker

    在宿主机执行。把容器名 octop 换成 docker ps 里的名字。镜像把 CLI 放在 /app/.venv/bin,并加入 PATH。

    docker exec -it octop octop user list
    docker exec -it octop octop user passwd <用户名> --password <密码>

    容器里找不到 octop 时:

    docker exec -it octop /app/.venv/bin/octop user passwd <用户名> --password <密码>

    首次部署的默认用户名是 admin,可用 OCTOP_ADMIN_USERNAME 覆盖。Compose 默认把宿主机 ~/.octop 挂到容器 /data/.octop,命令改的就是这份数据库。

    首次密码说明见 Docker 部署:修改管理员密码。

    飞牛OS

    Docker 版(页面一般是 http://<NAS的IP>:8088)— 在 NAS 终端或 SSH 中执行。容器名以 docker ps 为准:

    docker exec -it octop octop user list
    docker exec -it octop octop user passwd <用户名> --password <密码>

    容器里找不到 octop 时:

    docker exec -it octop /app/.venv/bin/octop user passwd <用户名> --password <密码>

    本地版(页面一般是 http://<NAS的IP>:8089)— 安装时会把 CLI 链到 /usr/local/bin/octop(指向 octop-cli)。SSH 进入 NAS 后:

    octop user list
    octop user passwd <用户名> --password <密码>

    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 user list
    octop user passwd <用户名> --password <密码>

    找不到 octop 时,使用该账户下的包装命令:

    ~/.octop/bin/octop user passwd <用户名> --password <密码>

    绝对路径一般是 /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。