Files
utun2/src/proxy/socks_proxy_doc.md
T
evgeny 451021b292 stcp: ed25519 pubkey exchange in handshake, fix instance destroy segfault, fix chat_tcp_test
- u_async.c: process immediate_queue BEFORE epoll_wait in uasync_poll
- stcp_link.c: defensive NULL etcp_conn/etcp_link in stcp_link_close
- utun_instance.c: move stcp_server_list_destroy_all to Phase J (before ETCP),
  add deferred drain in both Phase J and L
- stcp.h/c: STCP_HS_ENC_CLIENT 6→38, STCP_HS_ENC_SERVER 7→39,
  exchange ed25519_pubkey in both handshake directions
- etcp_connections.c: copy peer_ed25519 from STCP to ETCP_CONN in
  etcp_link_enter_ready_tcp; guard link->etcp in tcp_link_close_cb
- chat_sync.c: fix lk->conn NULL dereference for TCP links
- test_stcp.c: update stcp_server_create/stcp_client_connect callsites
- tools/chat_tcp_test: change transport udp→tcp
2026-08-07 00:48:27 +03:00

9.3 KiB

socks_proxy

1. Назначение

Модуль реализует клиентскую сторону SOCKS5 и HTTP CONNECT прокси. Принимает TCP-соединения от локальных приложений (curl, браузер), выполняет handshake (SOCKS5 или HTTP CONNECT), определяет целевой IP:port (с разрешением доменных имён через DNS) и мультиплексирует трафик через ETCP к exit node. Взаимодействует с tcp_proxy_server на стороне exit node.

Файлы:

  • src/proxy/socks_proxy.c — реализация
  • src/proxy/socks_proxy.h — интерфейс

2. Как пользоваться

Инициализация

struct socks_proxy_conn* conns = NULL;    // связный список активных соединений
int conn_count = 0;                       // счётчик соединений
uint32_t next_stream_id = 0;              // монотонный генератор stream_id
struct listen_ctx* listen = socks_proxy_init_listen(
    ua, "127.0.0.1:1080", &conns, &conn_count, &next_stream_id,
    inst, via_node_id, is_http);

is_http=0 — SOCKS5, is_http=1 — HTTP CONNECT/прокси.

Приём ETCP-данных от exit node

Внешний dispatcher (tcp_proxy_client) вызывает socks_proxy_handle_etcp() при получении ETCP-пакетов с svc_id=ETCP_RT_ID_TCP_PROXY:

int handled = socks_proxy_handle_etcp(&conns, &conn_count, stream_id, subcmd, data, data_len);
// handled=1 — найден и обработан, 0 — stream_id не найден

Поддерживаемые subcmd: DATA, CLOSE, ERROR, FIN.

Поиск соединения

struct socks_proxy_conn* c = socks_proxy_find_conn(conns, stream_id);
// обход связного списка, O(N)

Завершение

socks_proxy_conn_free_all(&conns, &conn_count);  // все соединения
socks_proxy_close_listen(ua, listen, &sock_out);  // слушатель

Ключевые нюансы

  • Бэкпрессур (backpressure): при неудаче etcp_route_send() данные сохраняются в tx_buf/tx_len, и регистрируется waiter через etcp_router_on_send_ready(). Когда ETCP готов к отправке, tx_waiter_cb повторяет попытку и возобновляет read_queue.
  • Несколько соединений: управляются через связный список struct socks_proxy_conn* + счётчик. Каждое соединение — отдельный TCP-сокет (tcp_conn) и независимый ETCP stream.
  • stream_id генерируется монотонно (++next_stream_id), передаётся в заголовке ETCP-пакетов для мультиплексирования.

3. API

Структуры

struct socks_proxy_conn — одно прокси-соединение:

  • tc — TCP-соединение с клиентом (tcp_conn)
  • stream_id — уникальный идентификатор потока в ETCP
  • dest_ip[4], dest_port — целевой адрес (куда хочет подключиться клиент)
  • state — текущее состояние (SOCKS_STATE_* или HTTP_STATE_*)
  • is_http — флаг: 0=SOCKS5, 1=HTTP
  • rem_closed, fin_remote, close_sent, close_pending — флаги состояния закрытия
  • buf[1024], buf_len — буфер накопления данных для парсинга handshake
  • tx_buf, tx_len, tx_waiter — бэкпрессур: отложенные данные и waiter handle
  • bytes_to_client, bytes_from_exit — счётчики переданных байт (диагностика)
  • head, count — указатели на голову списка и счётчик (для самоудаления)

struct listen_ctx (непрозрачный) — контекст слушающего сокета:

  • listen_sock, socket_id — сокет и uasync handle
  • conns, conn_count, next_stream_id — общий список соединений

Основные функции

Функция Описание
socks_proxy_init_listen(ua, addr, conns, count, next_sid, inst, via_node, is_http) Создаёт слушающий TCP-сокет на addr (IP:PORT). Возвращает listen_ctx*.
socks_proxy_close_listen(ua, ctx, sock_out) Закрывает слушающий сокет, освобождает ctx.
socks_proxy_handle_etcp(head, count, stream_id, subcmd, data, len) Диспетчер ETCP-сообщений от exit node. Обрабатывает DATA (→write_queue клиенту), CLOSE/ERROR (→push_close), FIN (→push_fin).
socks_proxy_find_conn(head, stream_id) Поиск соединения по stream_id в связном списке.
socks_proxy_conn_free(c) Освобождает соединение: отправляет отложенный CLOSE/ERROR в ETCP, удаляет из списка, освобождает tcp_conn, buffer, waiter.
socks_proxy_conn_free_all(head, count) Освобождает все соединения в списке.

Внутренние функции

Функция Описание
send_msg(inst, dst, subcmd, sid, data, len, force) Формирует ETCP-пакет: [TCP_PROXY_HDR_SIZE=6] svc_id(1)+subcmd(1)+stream_id(4) + payload, отправляет через etcp_route_send.
send_connect(c) Отправляет CONNECT (dest_ip[4]+dest_port[2]) на exit node.
send_data(c, data, len) Отправляет DATA (релей пользовательского трафика).
send_close(c), send_error(c), send_fin(c) Отправляют управляющие subcmd.
write_to_client(c, data, len) Запись данных в tc->write_queue (отправка клиенту через TCP).
process_socks_greeting(c) Парсинг SOCKS5 GREETING: ver=5, выбор метода 0x00 (no auth), ответ 05 00.
process_socks_request(c) Парсинг SOCKS5 CONNECT REQUEST (atyp=1/3/4, IPv4/IPv6/domain). DNS-резолвинг для доменов. Ответ 05 00 00 01 + dummy addr.
process_http_request(c) Парсинг HTTP: CONNECT host:port (туннель) или GET/POST с абсолютным URL (режим HTTP-прокси с переписыванием URL в относительный).
on_accept_cb(sock, arg) Callback accept: создаёт socks_proxy_conn, tcp_conn_create, вешает read callback.
on_read_cb(q, arg) Callback чтения из TCP: handshake-парсинг или релей данных через ETCP с бэкпрессуром.
tx_waiter_cb(q, arg) Callback бэкпрессура: повторная отправка отложенных данных при готовности ETCP.
on_fin_cb, on_error_cb, on_closed_cb Callback'и жизненного цикла tcp_conn: FIN→удалённый FIN, ошибка→send_error+free, закрыт→send_close+free.

4. Протокол

SOCKS5 flow (is_http=0)

Клиент → uTun:         [ver=5][nmethods][methods...]
uTun → Клиент:         [05][00]                              (GREETING: no auth)
Клиент → uTun:         [05][01][00][atyp][addr...][port]    (CONNECT REQUEST)
uTun → Клиент:         [05][00][00][01][0.0.0.0][0]         (ответ ок)
uTun → exit (ETCP):    TCP_PROXY CONNECT[dest_ip+port]
Клиент ↔ uTun ↔ exit:  RELAY данных через ETCP DATA

HTTP CONNECT flow (is_http=1)

Клиент → uTun:         CONNECT host:port HTTP/1.1\r\n\r\n
uTun → Клиент:         HTTP/1.1 200 Connection Established\r\n\r\n
uTun → exit (ETCP):    TCP_PROXY CONNECT[dest_ip+port]
Клиент ↔ uTun ↔ exit:  RELAY данных через ETCP DATA

HTTP-прокси (GET/POST, is_http=1)

Клиент → uTun:         GET http://host:port/path HTTP/1.1\r\nHost: ...\r\n\r\n
uTun → exit (ETCP):    TCP_PROXY CONNECT[dest_ip+port] + TCP_PROXY DATA[GET /path HTTP/1.1\r\n...]
Клиент ↔ uTun ↔ exit:  RELAY данных через ETCP DATA

URL переписывается в относительный (/path), остальные заголовки передаются как есть.

5. Зависимости

  • tcp_proxy_server.h — константы subcmd (TCP_PROXY_SUBCMD_*) и размер заголовка (TCP_PROXY_HDR_SIZE=6)
  • etcp.h / etcp_api.h — etcp_route_send(), ETCP_RT_ID_TCP_PROXY
  • etcp_router.h — etcp_router_on_send_ready(), etcp_router_cancel_send_ready(), etcp_router_waiter_cancel()
  • tcp_io.h / tcp_conn — TCP-соединения (tcp_conn_create, tcp_conn_push_close, tcp_conn_push_fin, write/read очереди)
  • u_async.h — event loop, uasync_add_socket_t
  • ll_queue.h — очереди (write_queue, read_queue), waiter механизм
  • memory_pool.h — аллокация из пулов (entry_pool, data_pool)
  • utun_instance.h — struct UTUN_INSTANCE