目 录CONTENT

文章目录

部署Nexus Terminal远程连接

过客
2025-11-24 / 0 评论 / 0 点赞 / 2 阅读 / 0 字

星枢终端(Nexus Terminal) 是一款国产的、现代化、功能丰富的 Web SSH / RDP / VNC 客户端,致力于提供高度可定制的远程连接体验。

Github地址: https://github.com/Heavrnl/nexus-terminal

一、功能特性

  • 多标签页管理 SSH 与 SFTP 连接
  • 支持 RDP/VNC 协议
  • 支持 PWA
  • 采用 Monaco Editor,支持在线编辑文件
  • 集成多重登录安全机制,包括人机验证(hCaptcha、Google reCAPTCHA)与双因素认证(2FA)
  • 高度可定制的界面主题与布局风格
  • 内置简易 Docker 容器管理面板,便于容器运维
  • 支持 IP 白名单与黑名单,异常访问自动封禁
  • 通知系统(如登录提醒、异常告警)
  • 审计日志,全面记录用户行为与系统变更
  • 基于 Node.js 的轻量级后端,资源占用低
  • 内置心跳保活机制,确保连接稳定

二、Docker中安装

创建目录

mkdir /home/nexus-terminal
cd /home/nexus-terminal

下载仓库中的 docker-compose.yml 和 .env 文件

wget https://raw.githubusercontent.com/Heavrnl/nexus-terminal/refs/heads/main/docker-compose.yml -O docker-compose.yml && wget https://raw.githubusercontent.com/Heavrnl/nexus-terminal/refs/heads/main/.env -O .env

启动

docker compose up -d

Nginx 反向代理

location / {
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Range $http_range;
    proxy_set_header If-Range $http_if_range;
    proxy_redirect off;
    proxy_pass http://127.0.0.1:18111;
}

三、飞牛Nas中安装

1. 整合yml文件

将官网.env 文件中的环境变量直接内联到 docker-compose.yml 中。

version: '3.8'

services:
  frontend:
    image: heavrnl/nexus-terminal-frontend:latest
    container_name: nexus-terminal-frontend
    ports:
      - "18111:80"
    depends_on:
      - backend
      - remote-gateway
    networks:
      - nexus-terminal-network

  backend:
    image: heavrnl/nexus-terminal-backend:latest
    container_name: nexus-terminal-backend
    environment:
      NODE_ENV: production
      PORT: 3001
      DEPLOYMENT_MODE: docker
      REMOTE_GATEWAY_API_BASE_LOCAL: http://localhost:9090
      REMOTE_GATEWAY_API_BASE_DOCKER: http://remote-gateway:9090
      REMOTE_GATEWAY_WS_URL_LOCAL: ws://localhost:8080
      REMOTE_GATEWAY_WS_URL_DOCKER: ws://remote-gateway:8080
      RP_ID: "yourdomain.com"
      RP_ORIGIN: "https://yourdomain.com"
    volumes:
      - ./data:/app/data
    networks:
      - nexus-terminal-network

  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
      DEPLOYMENT_MODE: docker
      REMOTE_GATEWAY_API_BASE_DOCKER: http://remote-gateway:9090
      REMOTE_GATEWAY_WS_URL_DOCKER: ws://remote-gateway:8080
      RP_ID: "yourdomain.com"
      RP_ORIGIN: "https://yourdomain.com"
    networks:
      - nexus-terminal-network
    depends_on:
      - guacd
      - backend

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

networks:
  nexus-terminal-network:
    driver: bridge
    name: nexus-terminal-network
    enable_ipv6: true
    ipam:
      config:
        - subnet: fd01::/80
          gateway: fd01::1

2. 创建Docker项目

进入飞牛Nas -> Docker 管理 -> Compose -> 新增项目 -> 输入项目名称 -> 上传上面的yml配置文件 -> 最后构建。

四、使用

1.创建账号

使用 域名/[IP:端口] 访问,第一次进入需要创建账号

2. 登录

登录后会进入仪表盘,会显示最近日志

3. 添加连接

  • 添加连接

切换到 终端 -> “+”号 -> 添加连接

  • 输入连接信息

这里支持 SSH、RDP、VNC 方式连接

4. 连接

  • SSH 连接

  • RDP 连接

  • VNC 连接

5. 使用

VNC和RDP就是正常的一个网页版连接,这里聊一下SSH模式下一些使用小功能。

  • 挂起会话组件
    可以在 SSH 标签页中右键选择“挂起会话”(移动界面长按即可)。一旦挂起,即使网页断开连接,后端也会自动接管并保持 SSH 连接不中断。你可以随时通过面板组件重新恢复会话,整个过程确保编译、长任务等操作不会因网络波动等原因中断。

  • 快捷键

  1. Ctrl + Shift + C 复制,Ctrl + Shift + V 粘贴
  2. 使用快捷指令,相当于把一个sh脚本编辑到一个快捷指令中,多服务器部署统一环境可以一键搞定


3. 文件传输,最下面一个相当于一个SFTP,可以简单的与本地做文件交互。

还有很多功能可以自己去探索,个人使用下来算是一款不错的网页远程连接客户端了。

0
  1. 支付宝打赏

    qrcode alipay
  2. 微信打赏

    qrcode weixin

评论区