Nexus Terminal Docker部署指南

一、项目介绍

Nexus Terminal（星枢终端）是一款现代化的Web SSH/RDP/VNC客户端，支持多标签页管理、文件在线编辑、Docker容器管理等功能，提供高度可定制的远程连接体验。

二、部署准备

环境要求

• Docker Engine 20.10+
• Docker Compose 1.28+
• 至少2GB内存

端口规划

三、部署步骤

1. 创建项目目录

mkdir -p ~/nexus-terminal && cd ~/nexus-terminal

2. 创建docker-compose.yml文件

version: '3'

services:
  frontend:
    image: heavrnl/nexus-terminal-frontend:latest
    container_name: nexus-terminal-frontend
    ports:
      - "18111:80"
    depends_on:
      - backend
      - remote-gateway
    restart: unless-stopped

  backend:
    image: heavrnl/nexus-terminal-backend:latest
    container_name: nexus-terminal-backend
    volumes:
      - ./data:/app/data
    environment:
      - NODE_ENV=production
      - PORT=3001
      - DEPLOYMENT_MODE=docker
      - REMOTE_GATEWAY_API_BASE_DOCKER=http://remote-gateway:9090
      - REMOTE_GATEWAY_WS_URL_DOCKER=ws://remote-gateway:8080
      - RP_ID=127.0.0.1  # 替换为服务器实际IP或域名
      - RP_ORIGIN=http://127.0.0.1:18111  # 替换为实际访问地址
    restart: unless-stopped

  remote-gateway:
    image: heavrnl/nexus-terminal-remote-gateway:latest
    container_name: nexus-terminal-remote-gateway
    environment:
      - GUACD_HOST=guacd
      - GUACD_PORT=4822
      - REMOTE_GATEWAY_API_PORT=9090
      - REMOTE_GATEWAY_WS_PORT=8080
      - FRONTEND_URL=http://frontend
      - MAIN_BACKEND_URL=http://backend:3001
      - NODE_ENV=production
    depends_on:
      - guacd
      - backend
    restart: unless-stopped

  guacd:
    image: guacamole/guacd:latest
    container_name: nexus-terminal-guacd
    restart: unless-stopped

3. 启动服务

docker-compose up -d

4. 查看服务状态

docker-compose ps

四、访问与配置

1. 打开浏览器访问：http://服务器IP:18111
2. 首次登录需注册管理员账号
3. 在设置界面配置：

   • 终端主题
   • 连接管理
   • 安全认证（支持2FA）
   • Docker管理面板

五、数据管理

• 配置数据存储路径：~/nexus-terminal/data
• 定期备份该目录以防止数据丢失：

  tar -czf nexus-terminal_backup_$(date +%Y%m%d).tar.gz ~/nexus-terminal/data
  

六、常见操作

停止服务

docker-compose down

重启服务

docker-compose restart

查看日志

docker-compose logs -f

七、注意事项

1. 生产环境建议修改默认端口18111为自定义端口
2. 公网部署需配置HTTPS（可通过Nginx反向代理实现）
3. 确保服务器防火墙开放18111端口（如使用ufw）：

   sudo ufw allow 18111/tcp
   

4. 若需修改服务端口，需同时更新backend的RP_ORIGIN环境变量