常见问题

如果你在使用上遇到问题，可以在此处寻找一些解决方案。如果仍旧无法解决你的问题，可到Issue区提出你的问题。

‼️不过在提问题前，请尽量确保能够提供以下信息：

1. X-UI版本信息
2. Xray版本信息
3. 问题简要描述
4. 相关错误日志

关于X-UI的版本信息，可以通过x-ui进入控制菜单后键入数字7进行查看
关于错误日志，可以通过x-ui进入控制菜单后键入数字12进行查看

SSL证书无法申请

使用脚本内置的证书申请，需满足以下条件，请仔细对照确认
1.域名已通过Cloudflare进行解析
2.获取Cloudflare Golbal API与邮箱
3.输入域名时请输入二级域名，如你解析到本机的域名为x-ui.example.com，请输入example.com
4.面板卸载不会影响到证书，请勿重复申请
5.免费域名可能无法通过DNS API方式进行申请
6.如遇到域名合法性校验失败,当前环境已有对应域名证书,不可重复申请,可使用如下命令后重新进行申请：

rm -rf ~/.acme.sh    

脚本提供的证书申请成功后会保存在/root/cert目录下，卸载X-UI并不会卸载证书，请勿重复申请

面板无法打开/白屏

1.请确保X-UI服务正常运行
2.请确保防火墙已经开放相关端口
3.请确保面板根路径没有错误
4.请确保浏览器语言设置正确,中文版本请设置为简体中文，英文版本请设置为En(US)
在以上内容都确认无误后，请尝试清除浏览器缓存、清除Cookie操作，若之后还未能进入面板，可以凭错误截图提交Issue

全局模式下无法访问国内网站

默认的配置模板中已经屏蔽掉对国内网站的访问，出于安全考虑，这是很有必要的
如果你不认可该策略，请自行修改配置模板

开启xray日志

如果你需要单独开启xray日志，可在配置模板内添加log字段即可,如下所示

{
  "log": {
    "access": "/usr/local/x-ui/bin/access.log",
    "error": "/usr/local/x-ui/bin/error.log",
    "loglevel": "warning",
    "dnsLog": false
 }

之后查看相关日志文件即可
当前脚本支持自动清除日志，可通过脚本中的定时任务配置进行开启，当日志文件大小大于一定数量(默认值:35M)时即会删除

更新geo

使用如下命令手动更新geo数据：

x-ui geo

当前脚本支持自动更新geo，可通过脚本中的定时任务配置进行开启
开启后将每隔两天于凌晨4点进行更新并自动重启
geo数据来源于Loyalsoldier

频繁提示设备接入IP变化

当前提示设备接入IP变化的前提是：当前存在设备（以IP为标识）通过节点端口进行接入。
如果您频繁收到该提示，可以通过以下方式进行确认:
1.开启xray日志查看是否存在相应IP进行接入
2.通过netstat或者ss命令进行检查确认,如下示例：

ss -atp state CONNECTED | grep xray

若存在非自己的IP进行接入，请考虑是否存在链接泄漏的风险

遗忘面板登录信息

若不小心遗忘面板登录信息，可键入x-ui获取功能菜单，键入数字7查看当前面板相关设定

关于数据备份与迁移

有关面板及配置的所有相关信息均存储在/etc/x-ui/x-ui.db,可以日常进行备份；如需数据迁移，将该数据库迁移至新服务器对应目录即可;
为保险起见，迁移时请先暂停x-ui，完成替换后再重新启动x-ui

Telegram bot其他功能可用，但是状态查询无法获取

出现该问题的原因很大可能上是由于你的节点过多，导致消息长度超过了Telegram的官方限制导致消息发送失败。

关于抗封锁性说明

X-UI本质上是为了解决很多新手用户不知道如何配置，不擅长Linux操作而产生的，其核心仍旧是xray core，使用X-UI与直接使用xray core不会有差异也不应有差异。当然，如果你是经验丰富的使用者，追求极高的自由度，仍建议直接使用xray core以满足更高的定制化需求

关于Telegram bot使用说明

1.由于当前内嵌的Bot会使用自定义的Command，建议绑定新申请的Telegram bot，否则会破坏你原本Bot的Command
2.当前Bot使用仅限于拥有者个人使用，如您需要在群组内进行使用，更加细化的权限控制，可以提相关Issue，视需求情况决定是否需要实现