Shellinabox 使用指南：基于 Web 的终端模拟器

# Shell in a box daemon configuration
# For details see shellinaboxd man page

# 是否自动启动
SHELLINABOX_DAEMON_START=1

# 监听端口（默认 4200，建议修改为随机端口增强安全性）
PORT=6175

# 运行用户和组
USER=shellinabox
GROUP=shellinabox

# 证书目录
CERTDIR=/var/lib/shellinabox

# 核心参数配置
# --no-beep: 禁用蜂鸣声（避免浏览器插件崩溃）
# --disable-ssl-menu: 禁止用户切换传输模式
# -s /:SSH:IP: 指定后端 SSH 服务器地址
OPTS="--no-beep --disable-ssl-menu -s /:SSH:192.168.1.100"

# 仅允许本地访问（配合反向代理使用）
# OPTS="-s /:SSH:192.168.1.100 --localhost-only"

# 禁用 SSL（仅在内网或已配置反向代理 SSL 时使用）
# OPTS="-t -s /:SSH:192.168.1.100"

Usage: shellinaboxd [OPTIONS]...
Starts an HTTP server that serves terminal emulators to AJAX enabled browsers.

List of command line options:
  -b, --background[=PIDFILE]  run in background
                              后台运行，可指定 PID 文件路径
                              
  -c, --cert=CERTDIR          set certificate dir (default: $PWD)
                              设置 SSL 证书目录，默认当前目录
                              
      --cert-fd=FD            set certificate file from fd
                              从文件描述符读取证书
                              
      --css=FILE              attach contents to CSS style sheet
                              附加自定义 CSS 样式文件
                              
      --cgi[=PORTMIN-PORTMAX] run as CGI
                              以 CGI 模式运行，可指定端口范围
                              
  -d, --debug                 enable debug mode
                              启用调试模式，输出详细日志
                              
  -f, --static-file=URL:FILE  serve static file from URL path
                              提供静态文件服务，如 -f favicon.ico:/path/to/icon.ico
                              
  -g, --group=GID             switch to this group (default: nogroup)
                              切换到指定用户组运行
                              
  -h, --help                  print this message
                              显示帮助信息
                              
      --linkify=[none|normal|aggressive] default is "normal"
                              URL 链接识别模式：none(不识别)|normal(默认)|aggressive(激进)
                              
      --localhost-only        only listen on 127.0.0.1
                              仅监听本地地址，配合反向代理使用
                              
      --no-beep               suppress all audio output
                              禁用所有音频输出（推荐，避免浏览器崩溃）
                              
  -n, --numeric               do not resolve hostnames
                              不解析主机名，使用 IP 地址
                              
  -m, --messages-origin=ORIGIN allow iframe message passing from origin
                              允许来自指定来源的 iframe 消息传递
                              
      --pidfile=PIDFILE       publish pid of daemon process
                              将守护进程 PID 写入指定文件
                              
  -p, --port=PORT             select a port (default: 4200)
                              指定监听端口，默认 4200
                              
  -s, --service=SERVICE       define one or more services
                              定义服务，格式：URL:USER:GROUP:HOME:COMMAND
                              
  -t, --disable-ssl           disable transparent SSL support
                              禁用 SSL，使用纯 HTTP
                              
      --disable-ssl-menu      disallow changing transport mode
                              禁止用户在菜单中切换 SSL/明文模式
                              
      --disable-utmp-logging  disable logging to utmp and wtmp
                              禁用 utmp/wtmp 登录记录
                              
  -q, --quiet                 turn off all messages
                              静默模式，关闭所有输出
                              
      --unixdomain-only=PATH:USER:GROUP:CHMOD listen on unix socket
                              仅监听 Unix 域套接字
                              
  -u, --user=UID              switch to this user (default: nobody)
                              切换到指定用户运行
                              
      --user-css=STYLES       defines user-selectable CSS options
                              定义用户可选的 CSS 主题
                              
  -v, --verbose               enable logging messages
                              启用详细日志记录（Apache 风格）
                              
      --version               prints version information
                              打印版本信息
                              
      --disable-peer-check    disable peer check on a session
                              禁用会话对等检查

server {
    listen 443 ssl;
    server_name shell.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:4200;
        proxy_http_version 1.1;
        
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket 支持（如需要）
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}