PsiTransfer文件传输系统配置指南

PsiTransfer文件传输系统配置指南

配置概述

PsiTransfer作为一款高效的文件传输系统，提供了灵活的配置方式以满足不同场景下的需求。本文将详细介绍PsiTransfer的三种主要配置方法，帮助管理员根据实际环境进行定制化部署。

配置方法详解

1. 基于NODE_ENV的配置文件

PsiTransfer采用环境相关的配置文件机制，系统会按照以下优先级加载配置：

1. 首先加载默认的config.js
2. 然后根据NODE_ENV环境变量加载对应的配置文件（如config.production.js）

典型应用场景：

• 开发环境：创建config.dev.js，使用npm run dev启动
• 生产环境：创建config.production.js，使用npm start启动
• 自定义环境：创建config.custom.js，通过NODE_ENV=custom node app.js启动

最佳实践： 建议将不同环境的配置完全分离，避免直接修改默认config.js文件，这样可以确保配置的清晰性和可维护性。

2. 环境变量配置

对于容器化部署或需要动态配置的场景，PsiTransfer支持通过环境变量覆盖所有配置项。

配置规则：

• 所有环境变量必须以PSITRANSFER_为前缀
• 变量名与配置项保持大小写一致
• 支持复杂数据结构（如JSON格式）

示例配置：

export PSITRANSFER_RETENTIONS='{"one-time":"一次性","3600":"1小时"}'
export PSITRANSFER_PORT=3000
export PSITRANSFER_ADMIN_PASSWORD='securepassword123'

优先级说明： 环境变量的优先级最高，会覆盖配置文件中相同项的设置。

3. SSL安全配置

推荐方案： 建议使用Nginx等专业Web服务器进行SSL终端卸载，这种方式性能更好且更安全。

原生SSL支持： 如需直接启用SSL，需配置以下参数：

• sslPort: SSL服务端口
• sslKeyFile: 私钥文件路径
• sslCertFile: 证书文件路径

安全证书设置示例：

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout /path/to/cert.key \
  -out /path/to/cert.pem

HTTP禁用： 将port设置为false可完全禁用HTTP服务，强制使用HTTPS。

WebHook集成配置

PsiTransfer提供了强大的WebHook机制，可实现与外部系统的无缝集成。

文件上传事件(fileUploaded)

触发时机：当文件上传完成时触发

配置项：fileUploadedWebhook

数据结构：

{
  "metadata": {
    "sid": "会话ID",
    "retention": 文件保留时间(秒),
    "password": "文件密码(明文)",
    "name": "文件名",
    "comment": "用户备注",
    "type": "MIME类型",
    "key": "文件唯一标识",
    "createdAt": 创建时间戳
  },
  "date": 事件触发时间戳
}

应用场景：

• 文件同步到云存储
• 上传日志记录
• 实时通知系统

文件下载事件(fileDownloaded)

触发时机：当用户下载文件时触发

配置项：fileDownloadedWebhook

数据结构：

{
  "sid": "会话ID",
  "name": "文件名",
  "date": "下载时间戳"
}

应用场景：

• 下载行为审计
• 流量监控
• 安全分析

配置建议

1. 安全配置：

   • 生产环境务必启用SSL
   • 为管理接口设置强密码
   • 定期更新证书和密钥

2. 性能调优：

   • 根据服务器资源调整并发设置
   • 合理设置文件保留策略
   • 考虑使用外部存储方案

3. 监控集成：

   • 配置WebHook实现监控告警
   • 记录关键操作日志
   • 设置合理的文件大小限制

通过以上配置指南，管理员可以根据实际需求灵活部署PsiTransfer系统，确保其安全、稳定、高效地运行。