在PsiTransfer中通过环境变量配置base_url的最佳实践

PsiTransfer作为一款优秀的文件传输工具，提供了灵活的配置选项。本文将重点介绍如何通过环境变量来配置base_url参数，这对于使用Docker部署的用户尤为重要。

为什么需要配置base_url

在实际部署中，特别是通过Docker容器化部署PsiTransfer时，我们经常遇到生成的下载链接不正确的问题。这通常是因为系统自动检测的基础URL与实际访问URL不匹配导致的。例如：

1. 当通过CDN等前端加速服务使用时，可能会受到文件上传大小限制
2. 在本地开发环境测试时生成的链接需要指向生产环境
3. 使用Docker部署时，容器内部网络与外部访问路径不一致

环境变量配置方法

PsiTransfer支持通过环境变量来覆盖配置文件中的设置，这为Docker用户提供了极大便利。要设置base_url，只需在启动容器时添加以下环境变量：

PSITRANSFER_BASE_URL=https://your-domain.com

这个环境变量的优先级高于config.json文件中的配置，确保了在容器化部署时的配置灵活性。

实际应用场景

1. 开发与生产环境分离：开发时可以使用本地地址，部署时通过环境变量切换为生产地址
2. 多实例部署：同一套代码部署到多个域名下，仅需修改环境变量即可
3. 临时测试：快速切换不同环境进行测试，无需修改配置文件

注意事项

1. 确保base_url以http://或https://开头，并以斜杠结尾
2. 在Docker Compose文件中，环境变量应放在environment部分
3. 修改环境变量后需要重启PsiTransfer服务才能生效
4. 如果同时存在环境变量和配置文件设置，环境变量优先级更高

通过合理使用环境变量配置base_url，可以大大简化PsiTransfer在不同环境下的部署和管理工作，特别是在容器化部署场景下，这种方法既保持了配置的灵活性，又遵循了十二要素应用的原则。