用 Muse 管理服务器的时候,最常遇到的一个需求是:能不能在浏览器里直接开一个终端,敲命令、看日志、改配置,而不用另外开一个 SSH 客户端?答案是可以。这篇文章就是这次实操的完整记录:用 ttyd 把工作机的终端搬到浏览器里,再用 Nginx 和 https 把它安全地暴露出来。
先说清楚,这篇讲的是“开通 terminal 登录”的具体做法,不是 Muse 本身的账号登录。Muse 的账号怎么开、权限怎么给,以实际环境为准;这里只讲终端这一段。
方案选型:ttyd + Nginx + https
方案分三层,每一层只做一件事:
- ttyd:把终端变成一个 Web 服务,浏览器打开就能用。
- Nginx:在本机做反代,把 ttyd 藏在后面,只暴露一个
/tty/路径。 - server1 的 Nginx + https:通过 SSH 反向隧道和
terminal.example.com的 https,把这个路径安全地发到公网。
这样做的好处是:ttyd 本身只监听本机,不直接暴露到公网;认证和加密都由前面的层来负责;每一层出问题,都可以单独排障。
第一步:装 ttyd,只监听本机
我们用的 ttyd 是 1.7.4 版本,通过系统包安装,版本号和安装方式以实际环境为准。装好之后,启动时要明确指定只监听本机:
ttyd -p 7681 -i 127.0.0.1 /bin/bash -l
拆开看:
-p 7681:监听 7681 端口。-i 127.0.0.1:只监听本机回环地址,不监听公网地址。这是关键的一步,ttyd 本身不直接对公网开放。/bin/bash -l:打开一个登录 shell。
除此之外,我们还启用了可写模式和 Basic Auth。可写模式的意思是浏览器里的终端真的能输入命令,而不是只能看;Basic Auth 的意思是访问之前要先输入用户名和密码,没有密码进不去。
用户名和密码在这里一律用占位符表示:
用户名:<你的用户名>
密码:<你的强密码>
真实的用户名和密码绝对不要写进文章、不要贴到聊天记录里、不要存进代码仓库。密码要单独生成一个强密码,不要复用别的网站的密码。
ttyd 的完整启动参数和服务配置以实际环境为准,生产上建议用 systemd 托管,断了自动重启。
第二步:Nginx 加一个 /tty/ 反代
ttyd 只监听本机,外面是访问不到的。下一步是在工作机 Nginx 里加一个 /tty/ 的 location,把它反代到 ttyd:
location /tty/ {
proxy_pass http://127.0.0.1:7681/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}
这里有几个点要注意:
proxy_pass指向的是127.0.0.1:7681,也就是 ttyd 本机监听的地址。- WebSocket 的升级头必须带上,不然终端能打开页面,但敲命令没反应,或者连接很快就断了。
Upgrade和Connection这两行就是干这个的。 - ttyd 启动时要加
--base-path /tty/,让它知道自己是挂在/tty/这个路径下面的,不然页面里的静态资源路径会对不上。
改完 Nginx 配置之后,记得检查配置、重新加载 Nginx,再验证。具体的检查和加载命令以实际环境为准。
第三步:走 https 出去
工作机上的 Nginx 只能在本机和隧道里访问,要让外面的人用浏览器打开,还要经过 server1。我们的路径是:
浏览器 --https--> terminal.example.com (server1 Nginx)
--> SSH 反向隧道 127.0.0.1:8080
--> 工作机 Nginx /tty/
--> ttyd 127.0.0.1:7681
server1 上的 terminal.example.com 复用了 *.example.com 的通配符证书,http 会 301 跳转到 https,所以浏览器里走的是加密连接,密码不会明文传。证书的有效期和续期方式以实际环境为准,续期之后记得 reload Nginx。
这一步的关键是:不要直接把 ttyd 的 7681 端口暴露到公网,也不要用 http 明文传密码。终端的密码一旦明文传输,被截获就等于服务器被接管了。
验证:401、200、101 三个状态码
验证分三步,每一步对应一个状态码:
第一步,不带密码访问:
https://terminal.example.com/tty/
预期返回 401,也就是“未认证”。这说明 Basic Auth 在正常工作,没有密码进不去。
第二步,带上正确的用户名和密码访问:
预期返回 200,页面能正常打开,终端能正常显示。这说明反代和 ttyd 都通了。
第三步,看 WebSocket 握手:
在浏览器的开发者工具里看网络请求,WebSocket 握手应该返回 101 Switching Protocols。这说明终端的实时通信已经建立起来了,敲命令会有回显。如果握手不是 101,先去检查 Nginx 的 WebSocket 升级头有没有配对。
本地也可以先验证一遍:直接访问工作机本机的 Nginx 的 /tty/,不带密码应该是 401,带上密码应该是 200。本地通了,再去测公网路径,这样排障的范围会小很多。
安全提醒:终端是最敏感的入口
浏览器里的终端,等于把服务器的 root shell 搬到了网上,安全上必须比普通页面严格得多:
- 密码务必单独生成强密码,不复用。 不要用你别的网站的密码,也不要用弱密码。密码泄露就等于服务器泄露。
- 链接和密码不要外传。 不要把带密码的链接发到群里,也不要截图把密码露出来。需要给别人用的时候,单独建账号、单独给密码,用完就收回。
- ttyd 只监听本机。 不要把它改成监听
0.0.0.0,不要直接把它暴露到公网。所有访问都必须经过 Nginx 和 https 这一层。 - 用完就关,不用就停。 如果只是临时用一下,用完就把 ttyd 服务停掉,把 Nginx 的
/tty/location 注释掉或者删掉。长期挂着一个能敲命令的入口,风险只会越来越大。 - 定期换密码。 密码用了一段时间之后就换掉,尤其是怀疑泄露的时候,马上换,不要等。
常见问题
页面能打开,但敲命令没反应?
先看 WebSocket 握手是不是 101。如果不是,多半是 Nginx 的升级头没配对,或者 ttyd 的 --base-path 和 Nginx 的 location 对不上。
不带密码也能打开?
说明 Basic Auth 没生效。先确认 ttyd 启动时有没有加认证参数,再确认是不是走了别的没有认证的路径直接访问到了 ttyd。
https 证书报错?
先确认域名解析对不对、证书有没有过期、Nginx 有没有 reload。证书问题不要绕过浏览器的警告继续用,那等于放弃了加密的意义。
总结
开通 Muse 的 terminal 登录,核心就三步:ttyd 只监听本机并加上认证,Nginx 用 /tty/ 反代并带好 WebSocket 头,再走 https 出去。每一步都只做一件事,每一步都能单独验证。
这个方案不复杂,但安全上的底线不能让:密码要强、要单独生成、不要外传;终端只监听本机,不要直接暴露;用完就关,不要长期挂着。做到这几点,浏览器里的终端就是一个很方便的工具;做不到,它就是一个很大的风险。