账户与令牌安全
登录、退出与访问令牌
同账号的同类官方客户端会复用登录签发的令牌;客户端退出不会撤销服务器上的令牌。网页令牌页可以撤销令牌,所有使用该令牌的设备随后都需要重新登录;开启 iCloud 账户或 Apple TV 同步时,登录状态也可能随同步改变。手动创建的令牌按所选有效期到期,不要与登录签发的长期令牌混淆
首次登录定制客户端
首次使用每种定制客户端时,可用邮箱和密码,或该客户端提供的「使用 Google 登录」,签发对应客户端的专属 Token。已有对应 Access Token 时,也可直接粘贴登录;填写 Token 本身,不是订阅网址
登录后,在 Access Token 管理 的「客户端登录签发」中找到对应客户端,之后可用复制按钮取得这条 Token 登录同类客户端(页面默认只显示后 4 位)。同账号同类客户端会复用令牌,不需要为每台设备重复创建
Google 入口目前适用于支持该功能的 oixCloud iPhone / iPad 版本和 FlClash for oixCloud。Apple TV 继续通过 iPhone 同步账户;Helper、OpenClash、oixClash 按各自教程选择邮箱/密码或 Token,不假定都有 Google 按钮
使用 Google 登录客户端
- 在客户端登录页点击「使用 Google 登录」,在系统认证窗口或浏览器中继续
- 选择与已有 oixCloud 账户邮箱一致的 Google 账户。此入口只登录已有账户,不会自动注册新账户
- 完成验证后允许返回原客户端;若浏览器没有自动返回,点击完成页的「返回 App」
- 等待账户信息和托管节点加载,再建立连接。超时或返回验证失败时,从客户端重新发起,不重复打开旧完成页
Google 登录需要客户端和网站同时支持。若当前版本没有入口,继续使用邮箱/密码或 Access Token;不要把 Google 密码填进 oixCloud 的密码框。用 Google 注册时,结果页会显示一次初始密码,同时发到邮箱。需要账户密码时,可在 Gmail(包括垃圾邮件)查找这封邮件;找不到时重置密码:已登录时打开 账户设置 → 登录密码,在展开的表单里「当前密码」下方点「忘记当前密码」,未登录时在 网站登录页 点「忘记密码」。重置后所有客户端需要重新登录,主订阅地址会更换,两步验证会关闭,Passkey 会清除
Google 登录排查
↔ 左右滑动,查看完整表格
| 现象 | 下一步 |
|---|---|
| 客户端没有按钮 | 核对安装版本和发行渠道;需要客户端与网站同时支持,维护源码中的功能不代表已进入所用稳定版 |
| 浏览器没有返回客户端 | 使用完成页的「返回 App」;流程超时或返回校验失败时,从客户端重新发起 |
| 提示邮箱未注册 | 选择与现有 oixCloud 账户邮箱一致的 Google 账户,或先在网站完成注册 |
| 已登录但没有节点 | 等待托管配置载入,核对套餐、节点筛选和同步结果 |
不要为排查浏览器跳转反复刷新 Access Token;这会使共用旧令牌的设备失效
禁止客户端邮箱/密码登录
- 先确认需要的客户端已有可用 Token,或能够通过受支持的 Google 入口登录
- 在 Access Token 管理 展开「客户端登录方式与安全提示」,开启「禁止客户端使用邮箱/密码登录」,等待保存成功
- 此后客户端和 API 的邮箱/密码登录被拒绝;现有 Token、网站登录和受支持的 Google 登录继续有效
旧页面可能把这个选项标为「仅允许 Access Token」,它实际限制的是邮箱/密码方式。如果某客户端没有 Google 入口且需要新签发 Token,可先在网站关闭此选项,用邮箱/密码登录后再开启
刷新客户端 Access Token
刷新会立即使旧 Token 失效,同账号同类客户端的所有共用设备都需要换用新 Token;客户端身份和绑定订阅保持不变
- 打开 Access Token 管理,在「客户端登录签发」中找到目标客户端
- 点击该记录的「重新生成」,核对影响范围,在弹窗里用 Passkey 或当前登录密码确认
- 等待页面重新加载,用复制按钮复制新 Token,并更新所有使用这条 Token 的设备;通过 iPhone 同步到 Apple TV 的账户也需重新同步
禁止客户端邮箱/密码登录时仍可刷新,无需临时开放邮箱/密码登录。若请求失败或结果不明确,先重新加载令牌页确认当前 Token,再决定是否重试。手动创建的 Token 不提供此按钮,需要更换时请删除后重新创建
创建手工令牌
- 在 Access Token 管理 点击「新增 Token」,选择有效期,填写便于识别的备注,并核对绑定的订阅
- 点击确认创建,在弹窗里用 Passkey 或当前登录密码确认,等待成功结果;页面重新加载时在「我创建的 Token」中查看新记录
- 同一账户最多保留 10 条手工令牌,客户端登录签发的令牌单独显示,不占这份额度
- 创建失败时先查看提示;结果不明确时刷新列表确认是否已创建,避免重复提交
手工令牌到期后不能继续认证,不会因使用而自动延期。不要把订阅网址填进 Token 登录框,也不要公开令牌截图
Telegram 绑定与每日通知
- 打开 账户设置 → 通知与绑定,Telegram 卡片标题旁显示「已绑定」或「未绑定」;未绑定时点「前往绑定」并按机器人提示完成,完成后页面会自动刷新。链接点击时生成,过期后重新点击「前往绑定」即可
- 卡片显示「已绑定」但写着「未设置 Telegram 用户名」时仍是已绑定,无需为了补用户名重复绑定
- 在旁边的「每日通知」卡片分别设置邮件和 Telegram 开关,等待下方状态确认;未绑定 Telegram 时,该通知开关不可用
- 保存失败或结果未确认时,先刷新页面核对实际状态再重试;正在保存时不要重复点击
每日通知开关只控制每日通知,不能据此判断安全、支付或服务状态提醒是否关闭。解绑后,Telegram 登录、每日通知、机器人、用户群及 Telegram 内置用户中心均会停用,操作前请确认不再需要该绑定
修改密码前确认影响
修改密码前,确认能够在相关设备完成以下更新:
↔ 左右滑动,查看完整表格
| 受影响的凭据 | 修改密码后的处理 |
|---|---|
| Access Token | 当前账户的令牌被撤销,相关客户端需重新登录 |
| Passkey | 已有记录被清除,不能继续登录网站,需要重新添加 |
| 旧主订阅地址 | 地址被删除,使用它的客户端需更新订阅地址 |
- 打开 账户设置 → 登录密码,链接会直接展开修改表单(从页面进入时在「登录密码」卡片点「修改」),填写当前密码、新密码及确认密码。忘记当前密码时,点该字段下方的「忘记当前密码」,改用邮件重置
- 确认能更新其他设备的登录信息后提交,等待成功提示
- 按提示重新登录网站,在令牌页重新获取所需客户端 Token,并更新使用旧主订阅地址的设备
- 重新添加仍需使用的 Passkey;开启账户同步时,检查其他设备和 Apple TV 的登录结果
若禁止客户端邮箱/密码登录,重新获取令牌时按 登录限制说明 处理。改密码不能替代逐项核对泄露内容,个人订阅地址等仍按下方对应表处理
添加和管理 Passkey
Passkey 用于网站登录,不是客户端 Access Token,也不是 TOTP 验证码
- 打开 账户设置 → 登录与安全,在 Passkey 卡片点「添加」
- 输入当前账户密码,已启用 TOTP 时再输入验证器当前生成的 6 位验证码,点击「继续」。已有 Passkey 时也可以点「使用已有 Passkey 验证」,验证通过后再点「继续」
- 按浏览器提示使用面容、指纹或 PIN 等方式验证,等待网站提示成功,确认列表出现新记录
- 可重命名记录,方便识别;删除前确认还有可用的登录方式,删除时要用 Passkey 或当前登录密码确认,删除后该 Passkey 不能再登录此账户
取消或超时后,从 Passkey 卡片的「添加」重新开始。已提交使用的 TOTP 码不要重复使用,等待验证器生成新码;只完成系统验证窗口而没有网站保存成功提示,不能视为注册完成。浏览器提示不支持时,使用支持 Passkey 的浏览器并确认当前是 HTTPS 页面
启用 TOTP 两步验证
启用后,使用密码登录网站时还需输入六位动态验证码;页面明确要求二次验证的敏感操作也需按提示完成。Passkey 是独立的登录方式,不是一次性密码
- 打开 账户设置 → 登录与安全,链接会直接打开设置弹窗(从页面进入时在「两步验证」卡片点「开启」)
- 按弹窗里的步骤用验证器扫描二维码,或手动录入显示的密钥。想换一个密钥时点「重新生成」,页面刷新后会回到这个弹窗,要用新的二维码重新添加
- 输入验证器生成的 6 位验证码,点「启用两步验证」,等待「TOTP 已成功启用」
- 保留可恢复验证器的安全方式;二维码和密钥能生成验证码,不要放入截图、日志或服务单
关闭时在「两步验证」卡片点「关闭」,同样需要有效验证码。验证失败时检查设备时间与所选账户,使用新生成的验证码再试;提示尝试过多时按页面要求等待。丢失验证器且无法完成验证时,通过 服务单 说明情况,不要反复删除登录凭据
修改昵称
打开 账户设置 → 个人资料,链接会直接展开「昵称」卡片的修改表单,填写新昵称并确认。昵称只能用字母和数字,最多 12 个字符,不能和别人重复
昵称一年只能自己改一次,第一次随时可以改;一年内卡片上会写明下次可以修改的日期。没有改成功(比如昵称已被使用)不占这次机会
修改登录邮箱
邮箱一年只能自己改一次,第一次随时可以改;一年内不能获取验证码,卡片上会写明下次可以修改的日期。没有改成功(比如验证码或密码不对)不占这次机会。确实要提前修改(比如旧邮箱已无法使用)时,通过 服务单 说明情况
- 打开 账户设置 → 个人资料,链接会直接展开「邮箱」卡片的修改表单;填写新邮箱并点「获取验证码」,在新邮箱一栏按回车也一样
- 从新邮箱读取验证码并填写,点击「修改邮箱」或在验证码一栏按回车,在弹窗里用 Passkey 或当前登录密码确认
- 确认页面提示修改成功。修改后当前登录会失效,用新邮箱重新登录,再核对账户中的邮箱
改邮箱的安全提醒使用变更前的联系方式,邮件提醒发往旧邮箱。如果收到的提醒不是本人操作,请立即联系支持。若提示密码错误次数过多,按页面提示等待后再试;功能被停用时无法从这里修改
哪些内容不能公开?
不要分享密码、Access Token、完整订阅地址、节点密码或证书私钥,截图和日志先隐藏这些内容。订阅泄露时在订阅页使用「重置」,然后更新所有设备的订阅与连接参数;该操作不会撤销 Access Token,令牌泄露需在令牌页单独刷新或删除
长期未登录的账户会被清理吗?
无有效套餐且符合清理条件的账户,余额和佣金均不大于 0 时,清理期限为 30 天;任一大于 0 时为 365 天。期限从最近登录活动与套餐到期时间中较晚的一项起算,不会仅因很久未登录,就在套餐到期当天立即删除
删除前 7 天、3 天和 1 天会发送提醒,有余额或佣金的账户会写明金额。账户删除后,余额和佣金一并清除,无法恢复
登录网站或客户端,或保持登录后的有效访问,可更新登录活动。仍有生效或有效待激活套餐、待处理提现或付款等未结事项时,会暂缓自动清理;封禁账户不按这套空闲规则自动删除。请以账户通知和当前状态为准
管理和撤销令牌
- 打开访问令牌页,按备注与来源找到目标客户端或手工令牌
- 更换一台设备时,先区分「仅退出这台设备」与「撤销服务器令牌」:官方客户端退出只清理本机登录状态
- 确认泄露或不再使用时在网页删除目标令牌;同账号同款客户端可能共用它,删除会影响这些设备
- 在仍需使用的客户端重新登录。若使用同步账户状态的设备,也检查同步后的登录结果
手工令牌有独立有效期,登录签发的令牌不会因为反复登录数量增多而自动回收。不要把所有设备共用一条客户端令牌理解为每台设备都能单独撤销
泄露后的对应处理
↔ 左右滑动,查看完整表格
| 泄露内容 | 对应操作 |
|---|---|
| 某条个人订阅地址 | 在订阅管理删除或更换该地址,并更新使用它的客户端 |
| 主订阅地址或连接参数 | 使用页面的「重置连接参数 & 主订阅地址」,阅读影响说明后更新所有相关设备 |
| Access Token | 在令牌页刷新客户端签发的令牌,或删除对应令牌;重置订阅地址不能代替这一步 |
| 登录密码 | 按 修改密码说明 更新令牌、主订阅与 Passkey;不要只换订阅 URL |
提交排查材料时保留错误和域名等必要信息,隐藏订阅路径中的密钥、登录 Token、节点密码、证书私钥及完整请求认证头