xugou/docs/常见问题.md

常见问题 (FAQ)

本文档收集了 XUGOU 使用过程中的常见问题及解决方案。

安装与部署问题

问题: Agent 报告无法连接到后端服务。

解决方案:

1. 确认后端服务 URL 是否正确配置
2. 检查网络连接是否正常
3. 确认 API 令牌是否正确
4. worker 的默认域名在国内无法访问，请替换为自定义域名

问题：创建 worker 时导入存储库页面找不到 xugou

一般这种情况是使用 通过 Git URL 克隆存储库 方式创建的，建议删除通过 cloudflare fork 的仓库，同时删除 github 上安装的 cloudflare App。然后重新手动 fork。 管理已安装的 GitHub App: https://github.com/settings/installations

问题：为什么数据库 ID 不使用环境变量？

现在的部署，是通过 cloudflare 的 wrangler 工具部署，没有设置 GitHub Action，而 cloudflare 在部署时会直接读取 wrangler.tom 文件中的值，我没找到设置环境变量的方式。 假如要使用环境变量，那么就需要改造现有的部署流程，引入 GitHub Action，我认为没必要，现有的方式已经足够。

使用问题

问题：部署完成以后，电脑可以访问，手机端不行

手机端打开代理就能访问，这或许是当地移动运营商屏蔽了 cf 的 ip?

问题：agent 显示“令牌签名无效”

改了 admin 用户的名字导致的，把名字改回去，重新生成 token 就好了

参考：https://github.com/zaunist/xugou/issues/77#issuecomment-3646078253