Add frp-ssh

apps/frp-ssh/9.1/data.yml

@@ -0,0 +1,78 @@
+additionalProperties:
+  formFields:
+    - default: 127.0.0.1
+      edit: true
+      envKey: LOCAL_ADDRESS
+      labelEn: Local Address
+      labelZh: 本地IP
+      required: true
+      type: text
+    - default: 12345
+      edit: true
+      envKey: LOCAL_PORT
+      labelEn: Local Port
+      labelZh: 本地端口
+      required: true
+      type: number
+      rule: paramPort
+    - default: 127.0.0.1
+      edit: true
+      envKey: SERVER_ADDRESS
+      labelEn: Server Address
+      labelZh: 服务端IP
+      required: true
+      type: text
+    - default: 2200
+      edit: true
+      envKey: SERVER_PORT
+      labelEn: Server Port
+      labelZh: 服务端端口
+      required: true
+      type: number
+      rule: paramPort
+    - default: tcp
+      edit: true
+      envKey: LOCAL_PROTOCOL
+      labelEn: Protocol
+      labelZh: 协议
+      required: true
+      type: select
+      values:
+        - label: TCP
+          value: tcp
+        - label: HTTP
+          value: http
+        - label: HTTPS
+          value: https
+        - label: TCPMUX
+          value: tcpmux
+        - label: STCP
+          value: stcp
+    - default: ''
+      edit: true
+      envKey: REMOTE_PORT
+      labelEn: Remote Port
+      labelZh: 远程端口（留空自动生成）
+      required: false
+      type: text
+    - default: ''
+      edit: true
+      envKey: PROXY_NAME
+      labelEn: Proxy Name
+      labelZh: 远程名称（留空自动生成）
+      required: false
+      type: text
+    - default: ''
+      edit: true
+      envKey: AUTH_USER
+      labelEn: Auth User
+      labelZh: 用户名
+      required: false
+      type: text
+    - default: 'token123456'
+      edit: true
+      envKey: AUTH_TOKEN
+      labelEn: Auth Token
+      labelZh: 密钥
+      required: true
+      type: text

apps/frp-ssh/9.1/docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  frpc:
+    image: finalgene/openssh:9.1
+    container_name: ${CONTAINER_NAME}
+    restart: always
+    network_mode: host
+    command: >
+      ssh -R ":80:${LOCAL_ADDRESS}:${LOCAL_PORT}" "v0@${SERVER_ADDRESS}" -p ${SERVER_PORT} ${LOCAL_PROTOCOL}
+      $([ ${REMOTE_PORT} ] && echo "--remote_port ${REMOTE_PORT}")
+      $([ ${PROXY_NAME} ] && echo "--proxy_name ${PROXY_NAME}")
+      $([ ${AUTH_USER} ] && echo "--user ${AUTH_USER}")
+      --token "${AUTH_TOKEN}"
+    labels:
+      createdBy: "Apps"

apps/frp-ssh/README.md

@@ -0,0 +1,166 @@
+# frp SSH Tunnel Gateway
+
+*Added in v0.53.0*
+
+## 概念
+
+SSH 支持反向代理能力 [rfc](https://www.rfc-editor.org/rfc/rfc4254#page-16)。
+
+frp 支持在 frps 端监听一个 ssh 端口，通过走 ssh -R 协议来完成 TCP 协议代理，该模式下不需要依赖 frpc。
+
+SSH 反向隧道代理和通过 frp 代理 SSH 端口是不同的 2 个概念。SSH 反向隧道代理本质上是在你不想使用 frpc 的时候，通过 ssh client 连接 frps 来完成基本的反向代理。
+
+## 参数
+
+```toml
+# frps.toml
+
+sshTunnelGateway.bindPort = 0
+sshTunnelGateway.privateKeyFile = ""
+sshTunnelGateway.autoGenPrivateKeyPath = ""
+sshTunnelGateway.authorizedKeysFile = ""
+```
+
+| Field | Type | Description | Required |
+| :--- | :--- | :--- | :--- |
+| bindPort| int | frps 监听的 ssh server 端口。| YES |
+| privateKeyFile | string | 默认为空。ssh server 使用的私钥文件，为空frps会读取 autoGenPrivateKeyPath 路径下的私钥文件。可复用本地 /home/user/.ssh/id_rsa 文件或自定义路径。| No |
+| autoGenPrivateKeyPath  | string |默认为 ./.autogen_ssh_key。文件不存在或内容为空，frps会自动生成 RSA 私钥文件内容存入该文件。|No|
+| authorizedKeysFile  | string |默认为空。空不对ssh客户端进行鉴权认证。不空可实现ssh免密登录认证，可复用本地 /home/user/.ssh/authorized_keys 文件或自定义路径。| No |
+
+## 基本使用
+
+### 服务端 frps
+
+最简配置
+
+```toml
+sshTunnelGateway.bindPort = 2200
+```
+
+将上述配置放入 frps.toml, 运行 `./frps -c frps.toml`，此时会在 2200 的端口监听，接受 ssh 反向代理的请求。
+
+注意：
+1. 使用最简配置，会在当前运行目录自动创建一个 `.autogen_ssh_key` 的私钥文件，frps 的 ssh server 会使用到该私钥文件，用来加解密数据。也可以复用本地已有的私钥文件，如 `/home/user/.ssh/id_rsa`。
+2. 最简配置模式下运行的frps，通过 ssh 连接 frps 是不鉴权的，强烈建议 frps 配置 token，在 ssh 命令行指定 token。
+
+### 客户端 ssh
+
+命令格式为
+
+```bash
+ssh -R :80:{local_ip:port} v0@{frps address} -p {frps ssh listen port} {tcp|http|https|stcp|tcpmux} --remote_port {real remote port} --proxy_name {proxy_name} --token {frp token}
+
+```
+
+1. `--proxy_name` 非必填，为空会随机生成一个。
+2. 登录 frps 的用户名统一为 v0，目前没有任何含义，即 `v0@{frps address}`。
+3. server 端的 proxy 监听的端口由 `--remote_port` 决定。
+4. `{tcp|http|https|stcp|tcpmux}` 支持的完整命令参数可通过 --help 获取。 如： `ssh -R :80::8080 v0@127.0.0.1 -p 2200 http --help`
+5. token 非必填，为了安全强烈建议在frps配置上token。
+
+####  TCP 代理
+
+```bash
+ssh -R :80:127.0.0.1:8080 v0@{frp address} -p 2200 tcp --proxy_name "test-tcp" --remote_port 9090
+```
+
+在 frps 启动一个 9090 的端口代理本地的 8080 服务。
+
+```bash
+frp (via SSH) (Ctrl+C to quit)
+
+User: 
+ProxyName: test-tcp
+Type: tcp
+RemoteAddress: :9090
+```
+
+等同于：
+
+```bash
+frpc tcp --proxy_name "test-tcp" --local_ip 127.0.0.1 --local_port 8080 --remote_port 9090
+```
+
+更多参数可执行 --help 获取。
+
+####  HTTP 代理
+
+```bash
+ssh -R :80:127.0.0.1:8080 v0@{frp address} -p 2200 http --proxy_name "test-http"  --custom_domain test-http.frps.com 
+```
+
+等同于
+
+```bash
+frpc http --proxy_name "test-http" --custom_domain test-http.frps.com
+```
+
+可以通过以下命令访问 http 服务：
+
+`curl 'http://test-http.frps.com'`
+
+更多参数可执行 `--help` 获取。
+
+#### HTTPS/STCP/TCPMUX 代理
+
+通过如下命令获取使用方式：
+
+`ssh -R :80:127.0.0.1:8080 v0@{frp address} -p 2200 {https|stcp|tcpmux} --help`
+
+## 高级使用
+
+### 复用本机的 id_rsa 文件
+
+```toml
+# frps.toml
+
+sshTunnelGateway.bindPort = 2200
+sshTunnelGateway.privateKeyFile = "/home/user/.ssh/id_rsa"
+```
+
+ssh 协议握手阶段需要交换公钥用来加密数据，所以 frps 端的 ssh server 需要指定一个私钥文件，可以复用本机已存在的；如果为空，frps会自动创建一个 rsa 私钥文件。
+
+### 指定自动生成私钥文件地址
+
+```toml
+# frps.toml
+
+sshTunnelGateway.bindPort = 2200
+sshTunnelGateway.autoGenPrivateKeyPath = "/var/frp/ssh-private-key-file"
+```
+
+frps自动创建私钥文件并指定路径存储。
+
+注意：frps 更换私钥文件，会导致 ssh 客户端登录失败，如果需要成功登录，可以删除 `/home/user/.ssh/known_hosts` 文件中的旧的记录。
+
+
+### 使用本机已存在的 authorized_keys 文件，实现 ssh 免密登录鉴权
+
+```toml
+# frps.toml
+
+sshTunnelGateway.bindPort = 2200
+sshTunnelGateway.authorizedKeysFile = "/home/user/.ssh/authorized_keys"
+```
+
+authorizedKeysFile 是 ssh 免密登录使用的文件，存放用户公钥信息，一行一个。
+
+authorizedKeysFile 为空， frps 不对 ssh 客户端进行任何认证。frps 不支持 ssh 用户名+密码模式认证。
+
+可复用本机已有的 `authorized_keys` 文件对客户端进行认证。
+
+注意：authorizedKeysFile 是 ssh 登录阶段的用户认证，token 是 frps 已有的认证，2 者没有关联，ssh 认证在前，frps 认证 token 在后，强烈建议至少开启1个，如果 authorizedKeysFile 为空，强烈建议 frps 端开启 token 认证，否则有安全风险。
+
+### 使用自定义的 authorized_keys 文件，实现 ssh 免密登录鉴权
+
+```toml
+# frps.toml
+
+sshTunnelGateway.bindPort = 2200
+sshTunnelGateway.authorizedKeysFile = "/var/frps/custom_authorized_keys_file"
+```
+
+自定义 `authorized_keys` 文件路径。
+
+authorizedKeysFile 文件变动可能会导致 ssh 登录认证失败，可能需要重新将公钥信息放入 authorizedKeysFile。

apps/frp-ssh/data.yml

@@ -0,0 +1,18 @@
+name: frp ssh 客户端
+tags:
+    - 实用工具
+title: 通过 ssh 协议与 frps 完成反向代理
+description: 通过 ssh 协议与 frps 完成反向代理
+additionalProperties:
+    key: frp-ssh
+    name: frp ssh 客户端
+    tags:
+        - Tool
+    shortDescZh: 通过 ssh 协议与 frps 完成反向代理
+    shortDescEn: using ssh protocol with frps
+    type: tool
+    crossVersionUpdate: true
+    limit: 0
+    website: https://github.com/fatedier/frp
+    github: https://github.com/fatedier/frp
+    document: https://github.com/gofrp/frp-doc/blob/master/content/zh-cn/docs/Features/common/ssh.md