设置项一览
「设置」页里每一项的含义、取值范围和默认值。具体数字以界面为准。
「设置」在侧栏里；手机上不在底栏，在「更多」里。分类分三组：
| 组 | 分类 | 管什么 |
|---|---|---|
| 我自己 | 「账号与安全」 | 登录密码、身份验证器、通知渠道验证码、登录中的设备 |
| 「外观」 | 明暗、界面语言、隐藏号码与卡号 | |
| 对外 | 「通知」 | 八个通知渠道 |
| 「AI 服务」 | 通话转文字与字幕翻译用的外部服务 | |
| 「API 与监控」 | API Key、API 文档、监控指标 | |
| 这个实例 | 「设备接管」 | 所在地区、设备接管清单 |
| 「代理内核」 | sing-box 代理内核的安装与运行 | |
| 「黄页」 | 机构号码目录、本地标记 | |
| 「GitHub 下载加速」 | 下载代理内核与黄页目录时用的加速代理 | |
| 「数据与备份」 | 备份、恢复、数据保留期限 | |
| 「关于」 | 版本与第三方授权 |
- 窗口足够宽时，分类表与内容并排显示。重新打开设置时回到上次看的分类。
- 更窄时先显示分类表，点进去是那一类，「‹ 设置」返回。
- 「搜索设置」按标题和常用别名匹配。例如搜
2FA能找到「身份验证器」和「通知渠道验证码」，搜Prometheus能找到「监控指标」。
nSIM 只有一个管理员账号。用户名和口令写在配置文件 web 段里，那是唯一来源，见配置文件。
| 设置项 | 内容 | 说明 |
|---|---|---|
| 「登录密码」 | 「当前密码」「新密码」「确认新密码」 | 新密码至少 8 位，不能是出厂口令，不能与用户名相同。改完后配置文件里只存口令的哈希，其他设备上的登录随之失效，当前这台保留 |
| 「身份验证器」 | 「状态」；「绑定身份验证器」或「更换验证设备」「重新生成恢复码」「解绑身份验证器」 | 6 位数、30 秒一换。绑定时给 10 个一次性恢复码。每个动作都要先在「当前密码」里输一次口令。用法见开启两步验证 |
| 「通知渠道验证码」 | 「启用」「推送渠道」「有效期（秒）」「最多尝试（次）」「当前密码」 | 有效期 30–1800 秒，默认 300；最多尝试 1–10 次，默认 5。「推送渠道」只能选已启用的渠道。保存后写入配置文件 |
| 「登录中的设备」 | 每个登录会话一行：浏览器与系统、IP 地址、最近活跃时间 | 当前这台标「本机」。点「强制下线」让那个会话立即失效。会话 30 天内没有使用就过期，每次使用会顺延 |
身份验证器与通知渠道验证码可以同时开。同时开时，登录页默认要身份验证器的 6 位数，可以点「改用通知渠道验证码」。
登录失败锁定
Section titled “登录失败锁定”| 规则 | 内容 |
|---|---|
| 什么算失败 | 口令错、两步验证码错，以及改密、绑定身份验证器等需要「当前密码」时输错 |
| 计数对象 | 只有一个计数，不论填的是哪个用户名 |
| 何时锁定 | 第 5 次失败起锁定。第一次锁 1 分钟，之后每次翻倍，最长 30 分钟 |
| 锁定期间 | 正确的口令也会被拒绝 |
| 重启 | 计数存在数据库里，重启 nSIM 不清零 |
| 何时清零 | 完整登录成功一次；或在另一台还登着的设备上解除；或最后一次失败后 24 小时内没有新的失败 |
| 在哪里看 | 「登录中的设备」里的「登录失败」一行，写着「最近 N 次」或「已锁定至」某个时间 |
| 怎么解除 | 点那一行的「解除锁定」，没锁定时这个按钮叫「清零」 |
另有一道按来源 IP 的限流：同一个 IP 在 2 分钟内最多尝试 10 次。它只存在内存里，重启后清零。
外观设置只影响当前这个浏览器，保存在浏览器本地。
| 设置项 | 取值 | 说明 |
|---|---|---|
| 「明暗」 | 「跟随系统」「浅色」「深色」 | 点了立即生效 |
| 「界面语言」 | 「简体中文」「English」 | 也决定字幕翻译默认译成哪种语言。English 目前只翻译了一部分 |
| 「隐藏号码与卡号」 | 开、关 | 打开后本机号码、ICCID、EID、IMSI 模糊显示。拨号页和 eSIM 页上的同名开关是同一个设置。只改界面显示，不处理日志和导出文件 |
八个渠道：「Telegram Bot」「飞书 Bot」「QQ Bot」「Bark」「Email」「Pushplus」「浏览器推送」「Webhook」。每个渠道的字段见通知渠道参数。
每个渠道在列表里一行，行尾的开关拨了立即保存。行下的状态：
| 状态 | 含义 |
|---|---|
| 「未配置」 | 必填项没填，渠道关着 |
| 「已配置，未启用」 | 填好了，渠道关着 |
| 「已启用」 | 填好了，渠道开着 |
| 「已启用，但配置不完整」 | 渠道开着，但必填项缺了，发不出去 |
通话转文字和字幕翻译用你配置的外部服务。三块各自独立，各有一个「启用」。通话转文字的开关不在这里，在「语音 › 语音设置」，见用 AI 转写通话。
| 块 | 做什么 | 接什么服务 | 字段 |
|---|---|---|---|
| 「实时识别」 | 边说边出文字，作为草稿 | 「协议」二选一：「Deepgram 兼容」，或「OpenAI Realtime」。地址以 ws:// 或 wss:// 开头 |
「接口地址」「密钥」「模型」「源语种」。自建服务可以不填密钥；「模型」留空用服务端默认 |
| 「整句识别」 | 一句说完后给出更准的结果 | 兼容 OpenAI /audio/transcriptions 的接口，地址填到 /v1 这一级 |
「接口地址」「密钥」「模型」「源语种」，前三项必填 |
| 「字幕翻译」 | 把识别结果翻成另一种语言 | 兼容 OpenAI /chat/completions 的接口，地址填到 /v1 这一级 |
「接口地址」「密钥」「模型」「译成」「不翻译的语言」「术语表」 |
- 「源语种」留空表示自动识别。「译成」留空跟随界面语言。
- 「不翻译的语言」填你看得懂的语言代码，例如
en, ja。这些语言的句子不发翻译请求。 - 「术语表」一行一条，写成「原词 → 译法」。
- 「临时结果间隔」只在只配了整句识别时出现。单位秒，0 为停用。启用后一句话说到一半就先出一版文字，费用约为原来的 2.5 倍。
- 「实时识别」的测试按钮是「保存并测试」；另两块是「保存并测试（会计费）」，因为测试会真的调用一次服务。
- 全部改完点页面的「保存」。
页面上的「工作方式」显示当前实际的组合：
| 显示 | 含义 |
|---|---|
| 「实时出草稿，说完一句由整句识别定稿」 | 实时识别与整句识别都配好了 |
| 「只用实时识别」 | 只配好了实时识别 |
| 「整句结束后输出文字」 | 只配好了整句识别 |
| 「识别未配置，通话不会转文字」 | 两种识别都没配好 |
API 与监控
Section titled “API 与监控”| 设置项 | 说明 |
|---|---|
| 「API Key」 | 列出可用的 Key，每把写着编号、能做什么、最近使用时间和过期时间。编号以 vpk_ 开头。能做什么写成「只读」或「可写 …」，带计费权限时加「含计费」。吊销过的收在「已吊销」里。新建时「有效天数」为 1–3650，留空不过期。用法见用 API Key 调用接口，权限见API 权限范围 |
| 「API 文档」 | 点「打开」在新标签页打开交互式接口文档 /api/docs。机器可读的规格在 /api/openapi.yaml 与 /api/openapi.json |
| 「监控指标」 | 「抓取地址」是 /api/system/metrics 的完整网址，Prometheus 文本格式，需要带 system:read 的 API Key。「当前指标」点「查看」显示指标原文 |
| 设置项 | 说明 |
|---|---|
| 「所在地区」 | 这台主机放在哪个国家或地区。nSIM 用它判断卡是否在漫游，见防止漫游产生费用 |
| 「设备接管清单」 | 打开「只接管清单内的设备」后，这个 nSIM 只管理「清单成员」里的模组，按 IMEI 匹配。从清单移出一台模组会立即释放它，它上面的 VoWiFi 与代理随之断开。接管步骤见接管一台模组 |
sing-box 外置内核的版本、平台、运行状态，以及下载、删除。Shadowsocks、VMess 等协议的节点需要它，SOCKS5 节点不需要。步骤见安装代理内核。
| 项 | 说明 |
|---|---|
| 自动下载 | 有启用的节点需要内核时才下载；只有 SOCKS5 节点或需要内核的节点都停用时不下载。失败后间隔逐步拉长重试 |
| 平台 | 按主机的实际 CPU 架构自动选，不用手动挑；装上后跑不起来时退回另一个兼容架构 |
| 校验 | 每次下载都核对 sha256，对不上就丢弃。校验值来自 GitHub 发布信息或 nSIM 内置的校验表，不经第三方加速服务获取。启动时还会再核对一次已安装的文件 |
| 安装位置 | nSIM 数据目录下的 sing-box 子目录。数据目录挂载成不可执行（noexec）时内核无法运行，「状态」会写出原因 |
| 运行状态 | 「运行状态」组显示内核进程是否「运行中」，并列出直接连接、经内核和等待内核的节点各有几个。个别节点被内核拒绝时列在「被内核拒绝的节点」里，其余照常运行 |
GitHub 下载加速
Section titled “GitHub 下载加速”下载代理内核和黄页目录时经过的加速代理，以及测速。步骤见加速从 GitHub 下载。
| 项 | 要求 |
|---|---|
| 协议 | 只支持 https:// |
| 格式 | 不能包含 ? 或 #，不能重复 |
| 目标 | 不能指向本机或局域网 |
| 数量 | 最多 8 个 |
| 与配置文件的关系 | 配置文件里的 github_mirror 一段只是出厂值。在界面上保存过之后，以界面为准 |
「机构号码目录」用来识别来电和短信的号码属于哪家机构；「本地标记」是你自己给号码做的标记。见识别来电号码。
| 设置项 | 说明 |
|---|---|
| 「备份口令」 | 填了就加密备份包，留空不加密。恢复加密的备份包时也在这里填打包时的口令。口令丢了，加密的备份包无法打开 |
| 「导出备份」 | 点「导出」下载备份包：加密时是 nsim-backup-….tar.gz.age，不加密时是 nsim-backup-….tar.gz。内容是数据库快照、配置文件和已下载的彩信附件。可视语音信箱的数据只进加密的备份包 |
| 「从备份恢复」 | 「选择文件」后点「上传并校验」，只检查不改数据；通过后选「恢复并重启」或「放弃此备份包」 |
备份包里有全部短信、通话记录、身份验证器密钥和配置文件，拿到它就等于拿到整个账号。步骤见备份与恢复。
超过期限的数据自动删除，0 表示永久。范围 0–3650 天；「审计日志」不为 0 时至少 30 天。
| 组 | 项目 | 默认 |
|---|---|---|
| 「用户数据」 | 「短信」「彩信图片与视频」「通话记录」「通话录音」「RCS 消息」 | 永久 |
| 「日志」 | 「自动化运行记录」 | 30 天 |
| 「短信送达跟踪」「通话转写」「审计日志」「短信拦截箱」 | 90 天 | |
| 「eSIM 通知历史」 | 180 天 |
缩短某项期限并保存时，确认框会点名哪些数据会被删。保存后立即删除超期的数据，不能撤销。
| 设置项 | 说明 |
|---|---|
| 「版本」 | 正在运行的 nSIM 版本。求助时先抄下这一行 |
| 「构建时间」 | 这个版本的构建时间 |
| 「配置路径」 | 实际读取的配置文件位置 |
| 「交流群」 | 用户交流群的链接 |
| 「第三方资源与授权」 | nSIM 使用的字体、图标、数据表等第三方资源及其授权协议全文 |