文档

快速开始 + 每部分每设备的功能说明(持续更新中)

快速开始

本文介绍如何安装部署 SSH Everywhere Plus 面板,并添加你的第一台服务器。

部署要求

项目要求
操作系统Linux(推荐 Debian 11+ / Ubuntu 20.04+),需有公网 IP
Python3.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 个:flaskflask-socketioparamikowerkzeug

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