> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 重置 Octop 账户密码

先看你属于哪一种情况，再打开对应小节。新密码至少 **8** 位，须同时包含字母和数字，且不能是常见弱口令（例如 `password123`、`admin123`、`octop123`）。

| 情况              | 做法                      |
| --------------- | ----------------------- |
| 还能登录，要改自己的密码    | [在页面中修改](#在页面中修改)       |
| 管理员要改其他用户的密码    | [管理员重置其他用户](#管理员重置其他用户) |
| 密码已忘记，且你能操作这台机器 | [在本机重置](#在本机重置)         |


> **说明**
> 
> 改密之后，`~/octop-login.txt` 和 Docker 的 `credential.txt` 仍是改密前的内容。请使用你刚设置的新密码。
> 


## 在页面中修改

登录页面后：


### 打开头像菜单

点击右上角头像。

### 修改密码

点击 **修改密码**，输入当前密码和新密码。

同一接口也可以用 curl 调用，见 [认证：修改密码](/api/authentication.md#修改密码)。

## 管理员重置其他用户

能登录的管理员可以为其他用户设置新密码，只需提供新密码。调用方式见 [用户与管理 API：重置密码](/api/users-admin.md#重置密码)。

管理员自己也进不去时，改用下一节，在安装 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 历史里，共用电脑时优先交互输入。不知道用户名时，先在同一环境列出用户。

先按安装方式选一节，再看你的系统：

- [命令行安装](#命令行安装)：`install.sh`、`install.ps1`、`install.bat` 或 `pip`
- [桌面客户端](#桌面客户端)

Docker、飞牛OS 和腾讯云在这两节后面。

### 命令行安装

安装脚本或 `pip` 会把 `octop` 放进 PATH。命令是：

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


**macOS / Linux**

安装脚本会把包装命令放到 `~/.octop/bin`，并写入 shell 配置。请新开一个终端，或执行 `source ~/.zshrc` / `source ~/.bashrc`。
```bash
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 octop` | `python3 -m octop`        |
例如：
```bash
~/.octop/bin/octop user passwd <用户名> --password <密码>
```


**Windows**

安装脚本会把 `octop` 写入当前用户的 PATH。请打开一个新的 PowerShell 或「命令提示符」：
```powershell
octop user list
octop user passwd <用户名> --password <密码>
```
仍提示找不到命令时，用包装命令（与登录页弹窗一致）：

```powershell PowerShell
& "$env:USERPROFILE\.octop\bin\octop.cmd" user passwd <用户名> --password <密码>
```
```bat cmd
%USERPROFILE%\.octop\bin\octop.cmd user passwd <用户名> --password <密码>
```

包装不存在时，再试 `%USERPROFILE%\.octop\venv\Scripts\octop.exe`。请确认 Octop 是用当前 Windows 用户安装的。


完成后打开 `http://127.0.0.1:8088`（或你实际绑定的地址），用新密码登录。

### 桌面客户端


**macOS**

```bash
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 <新密码>
```


**Windows**

NSIS 安装时把运行时展开到安装目录的 `resources\sidecar`，默认路径是：
`%LOCALAPPDATA%\Programs\Octop\resources\sidecar`
用户数据仍在 `%USERPROFILE%\.octop`。如果安装时改过目录，把下面命令里的安装前缀换成实际位置。

```bat cmd
set OCTOP_PY=%LOCALAPPDATA%\Programs\Octop\resources\sidecar\runtime\python.exe
set OCTOP_LAUNCH=%LOCALAPPDATA%\Programs\Octop\resources\sidecar\launch.py
"%OCTOP_PY%" "%OCTOP_LAUNCH%" user list
"%OCTOP_PY%" "%OCTOP_LAUNCH%" user passwd <用户名> --password <新密码>
```
```powershell PowerShell
$OCTOP_PY = "$env:LOCALAPPDATA\Programs\Octop\resources\sidecar\runtime\python.exe"
$OCTOP_LAUNCH = "$env:LOCALAPPDATA\Programs\Octop\resources\sidecar\launch.py"
& "$OCTOP_PY" "$OCTOP_LAUNCH" user list
& "$OCTOP_PY" "$OCTOP_LAUNCH" user passwd <用户名> --password <新密码>
```



### Docker

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

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

容器里找不到 `octop` 时：

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

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

首次密码说明见 [Docker 部署：修改管理员密码](/guide/quickstart-docker.md#修改管理员密码)。

### 飞牛OS

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

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

容器里找不到 `octop` 时：

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

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

```bash
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](/guide/fnos.md)。

### 腾讯云

**云服务器 CVM** — 在实例详情页点击 **登录**，选择 **免密连接（TAT）**。终端会从 root 切到 `agentuser`。然后执行：

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

找不到 `octop` 时，使用该账户下的包装命令：

```bash
~/.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 控制台** 为准。

开通步骤见 [在腾讯云中使用](/guide/use-in-tencent-cloud.md)。


> **注意**
> 
> 机器能从网络访问时，安装时生成或向导里的密码只适合首次登录。重置完成后，用新密码再登录一次。
> 


完整子命令见 [渠道与定时任务：octop user](/cli/channel-cron-commands.md#octop-user)。
