WeTTY与Nginx反向代理：生产环境部署完整方案

WeTTY与Nginx反向代理：生产环境部署完整方案

【免费下载链接】wetty 项目地址: https://gitcode.com/gh_mirrors/wet/wetty

WeTTY（Web + TTY）是一个强大的Web终端解决方案，通过浏览器提供完整的终端访问体验。在生产环境中，将WeTTY与Nginx反向代理结合部署，能够实现HTTPS加密、负载均衡和安全加固，为团队提供稳定可靠的远程终端服务。🚀

为什么要使用Nginx反向代理？

在生产环境中直接暴露WeTTY服务存在安全隐患，通过Nginx反向代理可以实现：

• HTTPS加密：保护终端会话数据安全
• 访问控制：基于IP地址或认证机制限制访问
• 性能优化：静态资源缓存和连接复用
• 高可用性：多实例负载均衡和故障转移

核心配置详解

Nginx反向代理配置

项目提供的nginx.template模板包含了完整的反向代理配置：

location ^~ /wetty {
  proxy_pass http://${WETTY_HOST}:${WETTY_PORT};
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  proxy_read_timeout 43200000;
  
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header Host $http_host;
}

关键配置说明：

• proxy_set_header Upgrade $http_upgrade：支持WebSocket协议升级
• proxy_set_header Connection "upgrade"：保持长连接
• proxy_read_timeout 43200000：设置超长超时时间（12小时）

WeTTY服务配置

在wetty.conf中配置WeTTY服务：

exec sudo -u root wetty -p 3000

部署实战步骤

1. 环境准备

确保系统已安装Node.js和Nginx，克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/wet/wetty

2. 安装依赖

cd wetty
pnpm install
pnpm build

3. Nginx配置优化

根据nginx.md文档，配置Nginx支持WeTTY的WebSocket连接至关重要。

4. 安全加固配置

在Nginx配置中添加安全头信息：

add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header X-Content-Type-Options "nosniff" always;

常见问题解决

WebSocket连接失败

确保Nginx配置中包含正确的Upgrade和Connection头信息，这是WeTTY正常工作的关键。

超时断开问题

调整proxy_read_timeout参数，确保长时间运行的终端会话不会意外断开。

性能调优建议

• 静态资源缓存：配置CSS、JS文件长期缓存
• 连接复用：启用HTTP/1.1协议支持
• 压缩传输：开启Gzip压缩减少带宽消耗

监控与维护

通过metrics.ts模块可以监控WeTTY服务运行状态，包括连接数、内存使用等关键指标。

总结

WeTTY与Nginx反向代理的结合为生产环境提供了安全、稳定的Web终端解决方案。通过合理的配置和优化，可以满足企业级应用的性能和安全需求。✨

部署过程中遇到问题，可以参考项目中的配置文档和开发文档获取更多帮助。

【免费下载链接】wetty 项目地址: https://gitcode.com/gh_mirrors/wet/wetty