超全 WebSSH 保姆级使用教程
超全 WebSSH 保姆级使用教程
解决：换电脑、没装 Xshell、临时办公、手机运维，浏览器直接连 Linux 服务器，全程复制即用。
一、两种主流工具选择
webssh（Python）：部署最简单，适合新手
ttyd（Go）：性能更强、更轻、资源占用低，推荐生产用
二、方案 1：快速部署 webssh（新手首选）
1. 安装依赖
bash
运行
# CentOS / Rocky / Almayum install -y python3 python3-pip# Ubuntu / Debianapt install -y python3 python3-pip
2. 安装 WebSSH
bash
运行
pip3 install webssh
3. 后台启动（常驻运行）
bash
运行
# 全局监听、端口设为 8888nohup wssh --address=0.0.0.0 --port=8888 > /dev/null 2>&1 &
4. 放行防火墙端口
bash
运行
# CentOS 系列firewall-cmd --permanent --add-port=8888/tcp firewall-cmd --reload# Ubuntu 系列ufw allow 8888
5. 访问 & 连接服务器
浏览器打开：
http://你的服务器IP:8888填写参数：
Host：服务器 IP
Port：默认 22
Username：服务器账号（root / 普通用户）
Password：服务器密码
点击 Connect 直接进入命令行终端
三、方案 2：部署 ttyd（更稳定、轻量）
1. 一键安装
bash
运行
wget https://github.com/tsl0922/ttyd/releases/download/1.7.7/ttyd.x86_64mv ttyd.x86_64 /usr/local/bin/ttydchmod +x /usr/local/bin/ttyd
2. 后台启动
bash
运行
nohup ttyd -p 8888 bash > /dev/null 2>&1 &
访问同上：
http://IP:8888，打开直接就是服务器终端。四、Docker 一键部署（不污染系统，最省心）
适合不想装环境、一键卸载场景
bash
运行
# 启动 webssh 容器docker run -d \ --name webssh \ -p 8888:8888 \ --restart always \ webssh/webssh
停止 / 卸载：
bash
运行
docker stop webssh && docker rm webssh
五、常用操作 & 使用技巧
- 字体 / 字号调整页面右上角设置，修改字体大小、配色，护眼暗色模式。
- 复制粘贴
复制：选中终端文字自动复制
粘贴：鼠标右键 / Ctrl+V
防止断网掉线
进入服务器后用
tmux持久会话：
bash
运行
tmux new -s ssh_session
断开重连后恢复：
bash
运行
tmux a -t ssh_session
多服务器管理
webssh 支持保存多个主机，下次打开直接一键切换连接。
六、必做安全设置（防止被爆破）
修改默认端口，不要用 8888
bash
运行
# 示例改成 15678nohup wssh --address=0.0.0.0 --port=15678 > /dev/null 2>&1 &
配置登录账号密码，禁止匿名访问
搭配宝塔 / Nginx 配置 HTTPS 加密访问
服务器限制 22 端口 IP 白名单
七、常见问题排查
打不开网页
检查服务器防火墙、安全组（云服务器必须放行端口）
检查进程是否启动：
ps -ef | grep wssh
连接失败
确认服务器 SSH 22 端口正常、密码 / 账号正确
服务器是否禁止密码登录、仅密钥登录
关闭 WebSSH 服务
bash
运行
# 杀掉进程pkill wsshpkill ttyd
