Wanderer项目安装后无注册链接的解决方案

问题背景

在使用Wanderer项目时，用户通过Docker Compose方式安装部署后，发现系统没有提供注册新用户的入口链接。这是一个常见的部署配置问题，主要涉及环境变量设置和基础配置检查。

核心问题分析

Wanderer项目默认情况下应该提供用户注册功能，注册页面通常可以通过以下两种方式访问：

1. 直接访问/register路径
2. 在登录页面点击"Make one"链接

如果这两个入口都不可见，最可能的原因是环境变量PUBLIC_DISABLE_SIGNUP被错误地设置为true，这会禁用用户注册功能。

详细解决方案

1. 检查环境变量配置

在docker-compose.yml文件中，确保没有设置或错误设置了以下环境变量：

environment:
  - PUBLIC_DISABLE_SIGNUP=false  # 确保不是true

2. 验证ORIGIN设置

多位用户反馈，即使注册功能开启，仍可能遇到注册失败的问题。这通常与ORIGIN环境变量配置不当有关：

• ORIGIN应该设置为Docker宿主机的实际IP地址或域名
• 错误的ORIGIN设置会导致前后端通信问题，影响注册功能

3. 完整部署检查步骤

1. 清理旧部署：docker compose down -v（删除所有容器和卷）
2. 修改docker-compose.yml，确保：
   • PUBLIC_DISABLE_SIGNUP=false或未设置
   • ORIGIN设置为正确的主机地址
3. 重新部署：docker compose pull && docker compose up -d

其他常见问题

在解决注册问题后，用户可能还会遇到：

1. 轨迹保存失败：通常与存储权限或数据库连接有关
2. 页面不自动刷新：这属于前端行为问题，可能是浏览器缓存或WebSocket连接问题

最佳实践建议

1. 首次部署时，建议保持所有默认设置不变
2. 逐步修改配置，每次修改后验证核心功能
3. 查看容器日志获取详细错误信息：docker compose logs -f

通过以上步骤，大多数注册功能相关的问题都能得到解决。如遇其他问题，建议检查日志并考虑创建新的问题报告以便开发者针对性解决。