文档
快速开始 + 每部分每设备的功能说明(持续更新中)
快速开始
本文介绍如何安装部署 SSH Everywhere Plus 面板,并添加你的第一台服务器。
部署要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux(推荐 Debian 11+ / Ubuntu 20.04+),需有公网 IP |
| Python | 3.8+ |
| 内存 | 512MB 以上(面板本身占用极低) |
| 端口 | 默认 5501(需在云防火墙/安全组放行) |
> 面板是部署在你自己的一台有公网 IP 的服务器上,然后通过它去远程管理你的其他服务器。被管理的服务器不需要安装任何东西。
安装步骤
1. 获取项目源码
# 将项目源码放到你的服务器上(以 /opt/ssh-everywhere-plus 为例) cd /opt git clone <项目仓库地址> ssh-everywhere-plus cd ssh-everywhere-plus
2. 创建虚拟环境并安装依赖
python3 -m venv venv source venv/bin/activate pip install -r requirements.txt
依赖只有 4 个:flask、flask-socketio、paramiko、werkzeug。
3. 启动面板
方式一:直接运行(测试用)
source venv/bin/activate python3 app.py
方式二:systemd 服务(推荐,开机自启 + 崩溃自动拉起)
创建 /etc/systemd/system/ssh-everywhere.service:
[Unit] Description=SSH Everywhere Plus - SSH Tunnel Manager After=network.target [Service] Type=simple User=root WorkingDirectory=/opt/ssh-everywhere-plus Environment=PORT=5501 ExecStart=/opt/ssh-everywhere-plus/venv/bin/python3 /opt/ssh-everywhere-plus/app.py Restart=always RestartSec=5 StandardOutput=append:/opt/ssh-everywhere-plus/service.log StandardError=append:/opt/ssh-everywhere-plus/service.log [Install] WantedBy=multi-user.target
然后启用并启动:
systemctl daemon-reload systemctl enable --now ssh-everywhere.service systemctl status ssh-everywhere.service # 确认 active (running)
4. 访问面板
浏览器打开 http://<你的服务器IP>:5501,用默认账号登录:
- 用户名:
admin - 密码:
123456
> ⚠️ 首次登录后请立即修改默认密码(在面板的设置/账户里)。
添加第一台服务器
登录后,在面板的「服务器管理」中添加你的目标服务器:
| 字段 | 说明 |
|---|---|
| 名称 | 自定义,便于识别(如「博客服务器」) |
| 主机地址 | 服务器的 IP 或域名 |
| 端口 | SSH 端口,默认 22(NAT 服务器填映射端口) |
| 用户名 | SSH 登录用户,通常 root |
| 认证方式 | 密码 或 私钥 |
| 分组 | 可选,用于归类多台服务器 |
添加后,面板会尝试 SSH 连接,成功后即可在仪表盘看到该服务器的健康状态,并开始使用文件管理、进程管理、崩溃防护等全部功能。
常见问题
- 连不上服务器? 先确认目标服务器的 SSH 端口能从面板服务器访问(云防火墙/安全组放行),账号密码正确。详见 常见问题 FAQ。
- 端口 5501 访问不了? 检查面板服务器的云防火墙/安全组是否放行了 5501 端口。
- 想改端口? 修改 systemd 服务里的
Environment=PORT=5501,然后systemctl daemon-reload && systemctl restart ssh-everywhere.service。