入门

Usage¶

Usage:
  C:\Users\Hunter\AppData\Local\Temp\go-build3142230917\b001\exe\rem.exe
        WIKI: https://chainreactors.github.io/wiki/rem

        QUICKSTART:
                serving:
                        ./rem

                reverse socks5 proxy:
                        ./rem -c [link]

                serve socks5 proxy on client:
                        ./rem -c [link] -m proxy

                remote port forward:
                        ./rem -c [link] -l port://:8080

                local port forward:
                        ./rem -c [link] -r port://:8080



Main Options:
  -c, --console=        console address
  -l, --local=          local address
  -r, --remote=         remote address
  -d, --destination=    destination agent id
  -x, --proxy=          outbound proxy chain
  -f, --forward=        proxy chain for connect to console
  -m, --mod=            rem mod, reverse/proxy/bind
  -n, --connect-only    only connect to console

Miscellaneous Options:
  -k, --key=            key for encrypt
  -a, --alias=          alias
      --version         show version
      --debug           debug mode
      --detail          show detail
      --quiet           quiet mode
      --dump            dump data

Config Options:
  -i, --ip=             console external ip address
      --retry=          retry times (default: 10)
      --retry-interval= retry interval (default: 10)
      --sub=            subscribe address (default: http://0.0.0.0:29999)
      --no-sub          disable subscribe

Help Options:
  -h, --help            Show this help message

QuickStart¶

命令行设计能简则简, {}中的内容为可省略的参数

rem 需要在被 client 与 user 都能访问到的一台机器上搭建一个对外暴露的中心服务器.

值得一提的是, 这个 console 并非实际意义上的 server, 而只是代理链路中平等的一环.

不需要任何参数启动的 rem 会自动生成连接链接与订阅链接

./rem

-i 可手动指定对外暴露的ip

这里的-i 可不填, 会自动尝试通过 ipip 获取外网 ip

每次启动都会生成随机的密钥以及各种加密混淆配置, 所以需要复制这里生成的配置连接, 用来在对端连接使用

反向代理¶

rem 默认的模式即为反向代理, 并会在 server 上启动 socks5 代理

./rem -c [link] {-r socks5://user:pass@0.0.0.0:12345}

极简参数

{}中的内容为可省略的参数

这行命令可以缩写为

./rem -c [link]

这个场景类似 frp 的 socks5 插件

client 通过 rem 支持的任意一种信道能连接到外网即可建立连接, 并在 server 端建立 socks5 服务.

user 位于外网, 通过 socks5 服务即可访问 client 所在的网络.

对外暴露不同的协议

rem 支持 socks5,http,trojan,shadowsocks 等协议, 可以指定任意协议, 具体请见文件:应用层

./rem -c [link] -r ss://

正向代理¶

与反向代理相反, 可以在 client 上搭建 socks5 服务，访问 server 所在的网络

./rem -c [link] -m proxy

工作模式

-m 表示工作模式, 请见文档:传输层

-m reverse 表示 inbound 位于 server 端

-m proxy 表示 inbound 位于 client 端

这个场景中 user 位于内网, client 通过 rem 支持的任意一种信道能连接到外网即可建立连接, 并在 client 端打开 socks5 服务.

user 可以通过 client 上监听的 socks5 服务实现出网, 访问 server 能访问到的网络. 在一些有各种限制的不出网场景中常用.

远程端口转发¶

server 会监听一个端口, 访问该端口的流量都会转发到 client 的指定端口

./rem -c [link] -l port://:8000

-l 与-r

一般来说, 这两个参数会在 client 端使用, 用来描述用户层协议.

-r 表示 remote, 即 server 端.

-l 表示 local, 即 client(自身)端

通过这两个参数的组合, 可以构造出任意想要的应用层功能

默认情况下, 未描述-r 会使用随机生成的端口. 也可以手动指定 server 的端口

./rem -c [link] -r :12345 -l port://:8000

等价于 ssh 的ssh -R 12345:localhost:8000 user@ip

-l 的 host 留空表示 127.0.0.1. 可以指定 client 内网 ip

./rem -c [link] -l port://[internal_ip]:8000

本地端口转发¶

与远程端口转发相反, client 监听一个端口, 访问该端口的流量会转发到 server 的指定端口

./rem -c [link] -r port://:8000 -m proxy

url 缩写¶

rem 中的 url 可以使用各种缩写表示默认值, 下面是一些常用的示例.

#socks5代理
socks5://:10086

# 只保留协议
ss://

# 指定端口
:12345

# 仅指定host, 自动补全其他参数
127.0.0.1

参数解释¶

当两个 rem 建立连接, 实际上就虚拟了一个传输层网络. 我们可以在这个网络上实现自由转发数据构造上层应用.

rem 提供了三种工作模式, 分别是:

reverse(默认) , 建立连接后 inbound 在 server 端, 会在 server 上监听来自端口接收数据
proxy, 建立连接后 inbound 在 client 端, 会在 client 上监听端口接收数据
bind, 简单工作模式, 不需要两个 rem 建立连接

每个 agent 进程在逻辑上行可以承载任意多个隧道, 自动根据 rem 之间建立的传输层信道链接复用. 为了命令操作方便, 一般情况下, 我们通过一行命令描述一个服务.

Console¶

Console当前支持的传输层

tcp 默认启用
udp (arq 协议: kcp) 默认启用
icmp (arq 协议: kcp)
unix , windows 上基于命名管道(SMB)实现, 非 unix 系统基于文件实现
websocket
wireguard
http (通过单工信道模拟, arq 协议 kcp)
memory 本进程中使用的虚拟信道

完整示例:

./rem -c [transport]://[key]:@[host]:[port]?wrapper=[]&tls=[bool]&tlsintls=[bool]&compress=[bool]

每个[]都表示可选项, 所有参都可留空，最简表达为搭建tcp协议的rem console，随机加密方式。

参数解释:

transport: 传输层，默认为tcp
key: 配置加密密钥，留空自动使用默认值
host: host留空或者为0.0.0.0 时表示监听rem console 服务, 其他值则为指定domain/ip的rem console
port: console 端口
wrapper: 留空自动生成随机加密方式，特殊值raw不启用任何加密方式
tls: 自动生成tls配置，并打开tls通讯，默认不启用
tlsintls，默认不启用

Local && Remote¶

rem 通过-l与-r 描述所有的应用层常见，通过-m描述流量方向。

三种mod:

reverse (默认值), 表示流量入口在server，会在server监听一个服务
proxy , 表示流量入口在client，会在client监听一个服务
bind , 单机模式, 搭建普通的http/socks5代理

应用层协议

socks5 (默认启用)
http/https (默认启用)
port forward (默认启用)
trojan
shadowsocks

通过组合remote, local , mod 即可实现各种应用场景。

todo: 有一些参数有特殊的配置, 正在补充

Forward¶

转发器, 用作 client 连接 server 时需要跨过的流量节点.

例如 client 连接 server 的时候可以通过多级代理, 常见于不出网内网但存在一个 http/socks5 代理让部分应用能够出网.

fowardd flag为-f/forward

./rem -c [link] -f socks5://192.168.1.1:1080 -f http://192.168.2.2:1081

使用场景：

目标网络环境不出网，但是给必须出网的应用配置了内部的 http 代理（192.168.2.2），并且限制了白名单 ip（192.168.1.1）访问内网出网代理。

先通过 192.168.1.1 绕过白名单限制，再通过出网代理建立代理

proxyclient的配置请见: https://chainreactors.github.io/wiki/libs/proxyclient/

Outbound Proxy¶

outbound会在某一端对外发起请求, 这个请求同样支持代理链。

例如反向代理场景，内网存在一个socks5代理跳板. 可以通过配置outbound proxy实现简单多级反向代理。

outbound proxy的flag为-x / --proxy

./rem -c [rem_link] -r socks5://:10080 -x socks5://10.1.1.1:1080

proxyclient的配置请见: https://chainreactors.github.io/wiki/libs/proxyclient/

级联¶

user <-> console <-[网络隔离]-> client

rem 的级联实现通过 -d/--destination 实现

每个连接对都会有唯一 ID, 也可以使用 alias(通过-a/--alias 自定义)

console 启动 rem

./rem

client 连接到 console

./rem -c [link] -a internal , 如果不填 alias,则是系统分配的 ip:port

user 通过 console 访问 client.

./rem -c [link] -d internal 将会在 client 监听一个 socks5 端口, 通过该端口可以直接访问到 user 所在的内网.

具体用法与非级联场景完全一致

本地反向代理: ./rem -c [link] -d internal 将在 user 监听 socks5 端口, 通过该端口可以直接访问到 client 所在的内网.

本地端口转发: ./rem -c [link] -d internal -l port://:12345 将会将 client 的 12345 端口转发到 user 的随机生成的端口

远程端口转发: ./rem -c [link] -d internal -l :8888 -m proxy 将会将 user 的 8888 端口转发到 client 的随机生成的端口

Clash订阅¶

默认情况下, 会自动自动打开clash订阅服务。

自动根据常见内网生成配置

proxies:
    - name: Sangfor-c0e9550e127fd067
      type: socks5
      server: 127.0.0.1
      port: 10086
      udp: true
      tls: false
      skip-cert-verify: true
mode: rule
rules:
    - IP-CIDR,10.0.0.0/8,10_NET
    - IP-CIDR,172.16.0.0/12,172_NET
    - IP-CIDR,192.168.0.0/16,192_NET
    - IP-CIDR,10.0.0.1/24,LOCAL_NET
    - MATCH,DIRECT
proxy-groups:
    - name: 10_NET
      type: select
      proxies:
        - Sangfor-c0e9550e127fd067
        - DIRECT
    - name: 172_NET
      type: select
      proxies:
        - Sangfor-c0e9550e127fd067
        - DIRECT
    - name: 192_NET
      type: select
      proxies:
        - Sangfor-c0e9550e127fd067
        - DIRECT
    - name: LOCAL_NET
      type: select
      proxies:
        - Sangfor-c0e9550e127fd067
        - DIRECT

可以通过-sub http://0.0.0.0:12345/abcd 指定clash订阅链接

可以通过 --no-sub 关闭clash订阅

Build¶

自动发布的release中, 默认仅支持 tcp/udp的transport和socks4/socks5, http/https, port forward 的应用层协议。

因此虽然实现了很多协议，但是其他协议需要手动启用.

rem 提供了自动编译指定协议, 以及固定配置的编译脚本。

https://github.com/chainreactors/rem-community/blob/master/build.sh

参数:

-o 指定架构 , -o linux/amd64
-t 指定传输层协议, -t "tcp,udp,icmp"
-a 指定应用层协议, -a "socks,http,trojan,shadowsocks"

某些情况下, 我们希望预配置rem参数, 可以通过以下参数实现, 与rem原命令行一致

当前支持

-m
-c
-r
-l

example:

sh build.sh -o "windows/amd64" -t "tcp,udp"

sh build.sh -c [rem_link]

sh build.sh -t icmp -a socks5