当前位置：首页 > news >正文

tcpfwd-doc

news 2026/8/7 1:26:25

tcpfwd — TCP 端口转发 (nostdlib ARM)

2026/7/2

基本信息

项目	值
源文件	`tcpfwd.c`(248 行)
编译产物	`tcpfwd`(1864 bytes)
目标平台	ZTE UZ901 热点 (ARMv7, Linux 3.4.110)
工具链	`arm-linux-gnueabihf-gcc -static -nostdlib -Os -s`
工作目录	`/tmp/`(RAM) 或`/mnt/userdata/`(JFFS2)

架构

┌──────────┐ TCP ┌──────────┐ TCP ┌──────────┐ │ Client │ ←────────→ │ tcpfwd │ ←────────→ │ Target │ │ (browser)│ listen │ (hotspot)│ connect │ (server) │ └──────────┘ port └──────────┘ ip:port └──────────┘

单线程、同步阻塞 poll 模型。每个连接串行处理（接受 → 转发 → 关闭 → 下一个）。

源码结构

1. 数据类型 (17-28行)

structsockaddr_in{shortsin_family;ushort sin_port;uint sin_addr;charpad[8];};structpollfd{intfd;shortevents;shortrevents;};

2. Syscall 包装层 (30-56行)

ARM EABI 纯内联汇编，r7传 syscall 号，r0-r4传参数。

staticlongs5(longn,longa0,longa1,longa2,longa3,longa4){registerlongr0asm("r0")=a0;registerlongr1asm("r1")=a1;registerlongr2asm("r2")=a2;registerlongr3asm("r3")=a3;registerlongr4asm("r4")=a4;registerlongr7asm("r7")=n;asmvolatile("svc #0":"+r"(r0):"r"(r1),"r"(r2),"r"(r3),"r"(r4),"r"(r7):"memory","cc");returnr0;}

简化宏：

s3(n,a0,a1,a2)→ 3 参数 syscall
s2(n,a0,a1)→ 2 参数 syscall
s1(n,a0)→ 1 参数 syscall

Syscall 映射

宏	编号	说明
`exit(n)`	1	退出
`read(f,b,l)`	3	读文件/套接字
`write(f,b,l)`	4	写文件/套接字
`open(p,f,m)`	5	打开文件
`close(fd)`	6	关闭 fd
`poll(f,n,t)`	168	IO 多路复用
`socket(d,t,p)`	281	创建套接字
`bind(f,a,l)`	282	绑定端口
`connect(f,a,l)`	283	连接目标
`listen(f,b)`	284	监听
`accept(f,a,l)`	285	接受连接
`setsockopt(f,l,o,v,s)`	294	设置选项

3. 工具函数 (58-93行)

writestr(fd, s)— 写字符串到 fd（自动计算长度）
htons(x)— 主机序转网络序（大小端交换）
parse_ip(out, pp)— 解析 IP 字符串 “1.2.3.4” →u32
parse_port(pp)— 解析端口字符串 “8080” →int
skip_spaces(pp)— 跳过空白字符

4. 转发核心 proxy_loop (95-142行)

staticvoidproxy_loop(intcfd,inttfd){charbuf[4096];while(1){structpollfdpfds[2];// 监视两个 fdpfds[0]={cfd,POLLIN};pfds[1]={tfd,POLLIN};intr=poll(pfds,2,-1);// 阻塞等待if(r<=0)break;// 检查错误事件if(pfds[0].revents&(POLLERR|POLLHUP|POLLNVAL))break;if(pfds[1].revents&(POLLERR|POLLHUP|POLLNVAL))break;// client → targetif(pfds[0].revents&POLLIN){r=read(cfd,buf,sizeof(buf));if(r<=0)break;// 全部写出（处理短写）char*bp=buf;intleft=r;while(left>0){intw=write(tfd,bp,left);if(w<=0)break;bp+=w;left-=w;}if(left>0)break;}// target → client (同上)if(pfds[1].revents&POLLIN){...}// 一方关闭后 break 并 close 两个 fd}close(cfd);close(tfd);}

关键设计：

单 4KB 缓冲区，两个方向共用（串行 poll，不会同时读写）
while (left > 0)循环处理短写（write 可能未写完所有字节）
任何方向 read ≤ 0 或 write ≤ 0 都断开整个连接
poll 超时 -1（无限等待）

5. 入口 _start (144-247行)

_start ├── open("/tmp/tcpfwd.conf", O_RDONLY) ├── read 配置 (最大 512 字节) ├── parse: 跳过 # 注释和空行 │ └── listen_port target_ip target_port ├── socket → bind → listen ├── writestr("tcpfwd: running\n") └── loop: ├── accept → 新 client fd ├── socket → connect target ├── proxy_loop(cfd, tfd) └── 断开后回到 accept

配置格式

/tmp/tcpfwd.conf:

8080 192.168.1.100 3000 # 或带注释: # 转发热点 8080 → 内网服务器 3000

只解析第一行有效规则
支持#行注释
支持空行

编译

arm-linux-gnueabihf-gcc-static-nostdlib-Os-s\-otcpfwd tcpfwd.c

或使用 WSL:

/opt/arm-linux-musleabihf-cross/bin/arm-linux-musleabihf-gcc\-static-nostdlib-Os-s-mfloat-abi=soft\-otcpfwd tcpfwd.c

部署

adb push tcpfwd /tmp/ adb shellchmod+x /tmp/tcpfwdecho"8080 192.168.1.100 3000"|adb shelltee/tmp/tcpfwd.conf adb shell"/tmp/tcpfwd &"

限制

限制	说明
单连接串行	一次只能转发一个连接，完成后才 accept 下一个
无 fork/线程	无法并发处理多个连接
无超时	poll(-1) 永久阻塞，僵尸连接不回收
4KB 缓冲区	超过 4KB 报文需多次 poll 转发
单规则	config 只读第一条规则
config 512B	文件最大 512 字节
硬编码路径	config 只读`/tmp/tcpfwd.conf`