萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Wetty 部署指南:瀏覽器訪問 Linux 終端、免密公鑰認證與 HTTPS 加密

Wetty 簡介

Wetty = Web + TTY,基於 Node.js + xterm.js + WebSocket,提供瀏覽器原生終端體驗,支援 SSH 連線、公鑰免密、TLS 加密、多用戶隔離。

部署環境

  • OS:CentOS 7 / Ubuntu 20.04+
  • Node.js ≥ 14 (建議 18 LTS)
  • Git、npm

安裝步驟

1. 安裝 Node.js 與依賴

# CentOS/RHEL (EPEL)
yum install -y epel-release
yum install -y nodejs npm git

# Ubuntu/Debian
apt-get update
apt-get install -y nodejs npm git

2. 克隆並安裝 Wetty

git clone https://github.com/krishnasrinivas/wetty.git
cd wetty
npm install          # 生產環境建議 npm ci --production
# 編譯 TypeScript (若來源為 TS 版本)
npm run build 2>/dev/null || true

3. 生成 TLS 證書 (HTTPS 必備)

openssl req -x509 -newkey rsa:2048 -nodes \
  -keyout key.pem -out cert.pem -days 365 \
  -subj "/CN=$(hostname)"

4. 建立系統服務 (systemd)

cat > /etc/systemd/system/wetty.service <<'EOF'
[Unit]
Description=Wetty Web Terminal
After=network.target

[Service]
Type=simple
User=wetty
WorkingDirectory=/opt/wetty
ExecStart=/usr/bin/node app.js --sslkey key.pem --sslcert cert.pem -p 3000 --sshauth=publickey --base /wetty/
Restart=on-failure
RestartSec=5
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
EOF

# 建立專用用戶
useradd -r -s /bin/false -d /opt/wetty wetty
chown -R wetty:wetty /opt/wetty
systemctl daemon-reload
systemctl enable --now wetty

免密公鑰認證配置

  1. 伺服器端生成鑰匙對 (或使用現有):ssh-keygen -t ed25519 -f ~/.ssh/wetty_key
  2. 將公鑰加入 ~/.ssh/authorized_keys:cat ~/.ssh/wetty_key.pub >> ~/.ssh/authorized_keys
  3. Wetty 啟動參數 --sshauth=publickey 並確保私鑰可被 Wetty 進程讀取 (放在 /opt/wetty/.ssh/,權限 600)。
  4. 瀏覽器訪問 https://host:3000/wetty/ssh/ 直接進入 Shell,無需輸入密碼。

修改源碼鎖定預設公鑰模式 (避免每次帶參數)

# 編輯 app.js (或 src/App.ts 重新建構)
# 找到 sshauth 默認值
const DEFAULT_SSH_AUTH = 'publickey';  // 原為 'password'
# 重新建構並重啟服務

反向代理 (Nginx + 域名 + 標準 443)

server {
    listen 443 ssl http2;
    server_name terminal.example.com;
    ssl_certificate /etc/letsencrypt/live/terminal.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/terminal.example.com/privkey.pem;

    location /wetty/ {
        proxy_pass https://127.0.0.1:3000/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 86400;
    }
}

安全加固建議

  • 僅允許內網/VPN 存取 3000 埠,對外僅開 443。
  • 啟用 fail2ban 監聽 Wetty 登入失敗日誌。
  • 定期輪換 TLS 證書 (Certbot 自動續期)。
  • 審計:journalctl -u wetty -f 監控連線行為。
copyright © 萬盛學電腦網 all rights reserved