SSLH 项目使用教程

SSLH 项目使用教程

sslhApplicative Protocol Multiplexer (e.g. share SSH and HTTPS on the same port)项目地址:https://gitcode.com/gh_mirrors/ss/sslh

1、项目的目录结构及介绍

SSLH 项目的目录结构如下：

sslh/
├── contrib/
├── debian/
├── docker/
├── doc/
├── examples/
├── scripts/
├── src/
├── tests/
├── .gitignore
├── .gitlab-ci.yml
├── .travis.yml
├── AUTHORS
├── CHANGELOG.md
├── CMakeLists.txt
├── CONTRIBUTING.md
├── COPYING
├── Dockerfile
├── INSTALL
├── Makefile.am
├── README.md
├── sslh.service
└── VERSION

各目录和文件的介绍如下：

• contrib/: 包含一些额外的脚本和工具。
• debian/: 包含用于 Debian 打包的文件。
• docker/: 包含 Docker 相关的文件和配置。
• doc/: 包含项目的文档文件。
• examples/: 包含一些示例配置文件。
• scripts/: 包含一些辅助脚本。
• src/: 包含项目的源代码。
• tests/: 包含测试脚本和测试数据。
• .gitignore: Git 忽略文件。
• .gitlab-ci.yml: GitLab CI 配置文件。
• .travis.yml: Travis CI 配置文件。
• AUTHORS: 项目作者列表。
• CHANGELOG.md: 项目变更日志。
• CMakeLists.txt: CMake 构建配置文件。
• CONTRIBUTING.md: 贡献指南。
• COPYING: 许可证文件。
• Dockerfile: Docker 构建文件。
• INSTALL: 安装指南。
• Makefile.am: Automake 配置文件。
• README.md: 项目自述文件。
• sslh.service: systemd 服务文件。
• VERSION: 项目版本号。

2、项目的启动文件介绍

SSLH 项目的启动文件主要是 sslh.service，这是一个 systemd 服务文件，用于配置和管理 SSLH 作为系统服务运行。

[Unit]
Description=SSL/SSH multiplexer
After=network.target

[Service]
ExecStart=/usr/sbin/sslh --foreground --user sslh --listen 0.0.0.0:443 --ssh 127.0.0.1:22 --ssl 127.0.0.1:443 --pidfile /var/run/sslh/sslh.pid
Restart=on-failure

[Install]
WantedBy=multi-user.target

• [Unit] 部分：定义服务的描述和启动顺序。
• [Service] 部分：定义服务的执行命令和重启策略。
• [Install] 部分：定义服务的安装目标。

3、项目的配置文件介绍

SSLH 项目的主要配置文件是 /etc/default/sslh，这是一个 shell 脚本格式的配置文件，用于配置 SSLH 的运行参数。

# /etc/default/sslh

# Run sslh as a daemon?
RUN=yes

# Additional options that are passed to the Daemon.
DAEMON_OPTS="--user sslh --listen 0.0.0.0:443 --ssh 127.0.0.1:22 --ssl 127.0.0.1:443 --pidfile /var/run/sslh/sslh.pid"

• RUN: 是否以守护进程模式运行 SSLH。
• DAEMON_OPTS: 传递给 SSLH 守护进程的额外选项。

配置文件中的选项解释如下：

• --user sslh: 以 sslh 用户身份运行。
• --listen 0.0.0.0:443: 监听所有接口的 443 端口。
• --ssh 127.0.0.1:22: 将 SSH 流量路由到本地的 22 端口。
• --ssl 127.0.0.1:443: 将 HTTPS/SSL 流量路由到本地的 443 端口。
• --pidfile /var/run/sslh/sslh.pid: 指定 PID 文件路径。

通过编辑这个配置文件，可以调整 SSLH 的运行参数

sslhApplicative Protocol Multiplexer (e.g. share SSH and HTTPS on the same port)项目地址:https://gitcode.com/gh_mirrors/ss/sslh