3x-ui面板怎么设置中文?没有汉化版,自带简体中文界面

搜"3xui 面板中文"的人,大多是装完面板发现界面是英文,想找个汉化版或者汉化教程。结论先说:3x-ui 不需要汉化版,面板自带简体中文,在界面上切一下语言就行。网上流传的"汉化包"“汉化脚本”,不但没必要,还多了来路不明的风险,别用。

依据说明:下面的内容来自我读 3x-ui(MHSanaei 版)当前主分支的源码和官方文档,没有在实机上逐个界面截图核对。面板界面这几年改过版,老版本(比如 2.9.4)的菜单位置和文字可能不一样,以你屏幕上看到的为准。

面板支持哪些语言

源码里的语言列表有 13 项:العربية、English、فارسی、简体中文(zh-CN)、繁體中文(zh-TW)、日本語、Русский、Tiếng Việt、Español、Indonesian、Український、Türkçe、Português。官方中文文档里也写了"13 种语言的界面"。所以中文是官方一直在维护的内置语言,不是第三方补丁。

怎么切换

方法一:登录页切换。 源码里登录页有一个语言选择控件,在没登录时就能换。选"简体中文"后页面会自动刷新。

方法二:登录后在面板设置里改。 源码里面板设置的"常规"页有"语言"一项,改完同样自动刷新。具体菜单在你版本上的位置,以界面为准。

语言保存在浏览器的 Cookie 里(源码里的名字是 lang,有效期一年)。这有两个后果:

  • 换浏览器、换设备、清了 Cookie,都要重新选一次,这不是面板丢了设置;
  • 用无痕窗口打开,每次都是默认语言。

为什么我的面板默认是英文

我看源码里的判断逻辑:没有 Cookie 的时候,面板读浏览器报告的语言代码,只有它刚好等于支持列表里的某一项(比如 zh-CN),才直接用中文;对不上就退回英文,并存一个英文的 Cookie。

源码里的"近似匹配"表只列了阿拉伯语、波斯语、日语、俄语等,没有包含单独的 zh。所以如果你的浏览器报告的是 zh、zh-HK 这类代码,我推断面板会显示英文。这是我读代码得出的推断,没有逐个浏览器测试。不管原因是什么,处理办法都一样:手动选一次简体中文。

Telegram 机器人的语言要单独改

机器人语言和面板语言是两个独立的设置。源码里面板设置的 Telegram 机器人页有"Telegram 机器人语言"一项,存在服务端设置里,不是浏览器 Cookie。面板是中文、机器人还是英文,就是这个原因。机器人本身怎么配置见Telegram 机器人。

官方的中文资料

  • 项目有官方中文 README(仓库里的 README.zh_CN.md);
  • 官方文档站 docs.sanaei.dev 有中文版,我打开核对过中文入口能访问,里面有安装、首次登录、配置、更新卸载和常见问题几个板块。

文档站是英文为主、中文为译文,译文可能落后于英文版,两边对不上时以英文为准,这点我没有逐页比对。

常见问题

  • 切了中文还有个别地方是英文:翻译不一定覆盖每个提示。我对比了源码里英文和简体中文翻译文件,条目数量一样,但"条目数一样"不代表每一条都译得准确或自然。
  • 想要别的汉化风格:没有官方途径,不建议改文件。
  • 选了语言页面没变:先强制刷新或清掉这个站点的 Cookie 再试。

相关文章

没有覆盖的

  • 原版 x-ui(vaxilu)的语言支持:没有核对。
  • S-UI 面板的语言:是另一个项目,没有核对,这篇不写。
  • 老版本面板切换语言的菜单位置:没有逐版本核对。
  • 各个翻译条目的准确度:只核对了条目数量,没有逐条审读。