manta/gofaster/app/CONFIGURATION.md

GoFaster 应用配置说明

服务地址配置

GoFaster 应用支持多种方式配置服务连接地址，优先级从高到低如下：

1. 用户设置（最高优先级）

在应用的"用户设置"页面中，可以修改"API地址"字段。修改后会自动更新状态栏中显示的"服务地址"。

2. 环境变量配置

可以通过环境变量覆盖默认配置：

# 设置API基础地址
export VUE_APP_API_URL=http://your-server:8080

# 设置服务器地址
export VUE_APP_SERVER_URL=http://your-server:8080

# 设置WebSocket地址
export VUE_APP_WS_URL=ws://your-server:8080/ws

3. 默认配置（最低优先级）

如果上述配置都没有设置，应用将使用以下默认值：

• 开发环境: http://localhost:8080
• 生产环境: https://your-production-domain.com
• 测试环境: http://localhost:8081

配置文件位置

• 应用配置: src/config/app.config.js
• 环境配置: src/config/env.config.js
• 用户设置: 存储在浏览器的 localStorage 中

配置生效方式

1. 环境变量: 需要重启应用才能生效
2. 用户设置: 保存后立即生效，状态栏会实时更新
3. 默认配置: 应用启动时自动加载

状态栏显示

状态栏中的"服务地址"字段会显示当前实际使用的服务地址，包括：

• 如果用户设置了自定义API地址，显示用户设置的地址
• 如果设置了环境变量，显示环境变量中的地址
• 否则显示默认配置中的地址

注意事项

• 修改API地址后，所有相关的API请求都会使用新的地址
• 确保新的服务地址可以正常访问，否则可能导致功能异常
• 生产环境建议使用HTTPS协议
• WebSocket地址需要与HTTP地址保持一致的协议（HTTP对应WS，HTTPS对应WSS）