# 登录二次验证

跟完这篇，你的账号在密码之外多一道 6 位验证码——别人光有密码进不来，而你自己手机丢了也还有路进得去。

> **ℹ️ 开始之前**
>
> 入口在**我的账号 → 登录安全**（经典界面从「平台配置」进，桌面界面在开始菜单里）。二次验证是每个人给自己开的，管理员不能替别人开，也没有「强制全家都开」的开关。动手前先在手机上装一个验证器 App——就是那种每 30 秒换一次 6 位数字的小工具，微软验证器、Google 身份验证器、1Password、Bitwarden 都可以。

## 一、开启验证器

1. **打开登录安全**

   **去哪里**：我的账号 → 登录安全 → 最上面的「验证器」。

2. **开始绑定**

   **做什么**：点「启用验证器」。上次开到一半退出去的话，按钮会显示「继续绑定」，接着点就行。

3. **扫二维码**

   **做什么**：用验证器 App 扫屏幕上的二维码。正拿手机看这个页面、不方便扫的话，点密钥旁边的「复制」，在 App 里选手动添加再粘贴。

4. **输入 6 位数字**

   **做什么**：把 App 上显示的数字填进「验证码」，点「确认启用」。
   **怎么算成功**：卡片上的状态从「未启用」变成「已启用」。

5. **把 10 个恢复码存好**

   **做什么**：这一步会一次性给出 10 个恢复码，复制到密码管理器里，或者打印出来放抽屉。存好之后点「我已保存」。

> **⚠️ 恢复码只出现这一次**
>
> 离开那个页面就再也看不到了——云瞰不留明文副本。当时没存下来也不用把验证器重绑一遍：回到同一张卡点「重新生成恢复码」，输一次当前密码就能换一批新的，旧的同时作废。

## 二、以后登录会多一步

开启之后，网页后台和手机 App 的登录都变成两步：先用户名密码，再输验证器上的 6 位数字。数字每 30 秒换一次，输的时候看当前显示的那个就好。

- **网页** —— 密码这一步通过后出现验证码输入框，下面还有一行「改用恢复码」。
- **Android / iOS App** —— 同样多一页验证码，也能切到恢复码。登录一次之后照旧记住，不用每天都输。
- **连着输错 5 次会锁 5 分钟** —— 防的是别人拿着你的密码慢慢猜验证码。等 5 分钟再试就行，不需要找管理员解锁。

> **ℹ️ 手机时间不准会一直提示验证码错误**
>
> 验证器算的是「当前这个时间该显示什么」，手机时钟和服务器差出半分钟以上就对不上了。把手机的日期时间设成自动获取，通常一下就好了。

> **ℹ️ 用单点登录进来的不用再输一遍**
>
> 点「使用 XX 登录」进来的话，验证在对方那边已经做过了，云瞰不会再要一次验证码。见〈[单点登录](/docs/sso)〉。

## 三、手机丢了、验证器被清空了

1. **先用恢复码**

   **做什么**：在登录页的验证码那一步点「改用恢复码」，填一个当初存下来的码。
   **注意**：每个码只能用一次，用掉就少一个。卡片上会显示还剩几个，剩得不多时点「重新生成恢复码」换一批。

2. **进去之后重新绑一台手机**

   **做什么**：我的账号 → 登录安全 →「停用验证器」（要输当前密码），然后重新走一遍第一节，用新手机扫码。

3. **恢复码也没了，找管理员**

   **做什么**：让管理员在**平台配置 → 用户管理**里点开你 →「安全 & 测试」→「重置二次验证」。
   **之后**：你的密码不变，下次登录只要密码，进去以后再重新绑一个新手机。

> **⚠️ 唯一的管理员请务必存好恢复码**
>
> 管理员不能重置自己的二次验证——这道限制防的是「有人摸到你已经登录的浏览器，顺手把二次验证关掉」。所以家里只有一个管理员时，恢复码就是唯一的自助出口。稳妥一点的做法：把恢复码放进密码管理器，再多建一个管理员账号备用。

## 四、关掉它

我的账号 → 登录安全 →「停用验证器」，输一次当前密码即可。停用之后登录只要密码，恢复码同时全部作废。换手机、换验证器 App 也是走「停用 → 重新启用」这一条路。

## 五、哪些地方还用不了

二次验证覆盖网页后台和手机 App。下面这几处目前只认用户名密码，遇到开了二次验证的账号会登录失败：

- **连在电视上的大屏界面** —— 给它单独建一个不开二次验证的账号，权限按只读给就行。
- **旧版手机 App** —— 会提示登录失败但说不清原因，把 App 更新到新版即可。
- **旧版 Home Assistant 集成** —— 新版已经改成「跳到云瞰点授权」，开着二次验证也能连；停在旧版的话先升级，见〈[Home Assistant 集成](/docs/home-assistant)〉。

## 六、常见问题

- **提示验证码不正确，但我确认没输错** —— 十有八九是手机时间不准，见上面那条。也可能是 App 里存了同名的两条（换过服务器地址时容易发生），删掉旧的那条。
- **能不能不用手机** —— 可以。1Password、Bitwarden 这类密码管理器的桌面版也能当验证器，扫码那一步直接在电脑上完成。
- **开了之后手机 App 每次都要输吗** —— 不用。App 登录一次之后照旧保持登录，只有重新登录才会再要。
- **管理员能看到我的验证码或恢复码吗** —— 看不到。恢复码只在生成那一刻显示一次，服务器上存的是不可还原的摘要；管理员能做的只有「清掉你的二次验证」这一件事，清完他也进不了你的账号（还得有密码）。
- **我给自己开了，家人是不是也得开** —— 各开各的，互不影响。

## 相关教程

- [通行密钥](/docs/passkeys)——用指纹或面容登录，比验证码更省事
- [单点登录](/docs/sso)——用群晖账号、公司账号登云瞰
- [用户与权限](/docs/users)——管理员怎么帮家人重置

---

来源:https://yun-kan.com/zh-CN/docs/two-factor