Amnezia-box (форк sing-box от Amnezia) с AmneziaWG 2.0

[hoaxisr]

Совершенно случайно наткнулся на форк sing-box от команды Amnezia (https://github.com/amnezia-vpn/amnezia-box)

Собрал для тестирования у себя и обнаружил, что в данном форке есть проблема с работой AmneziaWG при использовании FakeIP.

Спойлер

### Root Cause

The AWG endpoint struct embedded `*awg.Device`:

```go
type Endpoint struct {
    *awg.Device  // ← Embedded, provides DialContext/ListenPacket
    // ...
}
```

This caused `Endpoint.DialContext()` to inherit from `awg.Device.DialContext()`, which:
1. Did not check if destination was a domain (FQDN)
2. Passed domains directly to netstack's dial function
3. Netstack attempted internal DNS resolution and failed

Meanwhile, the standard WireGuard endpoint (`protocol/wireguard/endpoint.go`) properly handles this:

```go
func (w *Endpoint) DialContext(ctx context.Context, network string, destination M.Socksaddr) (net.Conn, error) {
    if destination.IsFqdn() {
        destinationAddresses, err := w.dnsRouter.Lookup(ctx, destination.Fqdn, adapter.DNSQueryOptions{})
        // ... resolve and dial
    }
    return w.endpoint.DialContext(ctx, network, destination)
}
```

Если вам нужно использовать FakeIP и AmneziaWG 2.0 то с помощью железного разума получилось это поправить (https://github.com/hoaxisr/amnezia-box) 

Собранные для arm и amd64 исполняемые файлы лежат тут (https://github.com/hoaxisr/amnezia-box/releases/)

 Доступные сборки:
  | Версия:        | Основано на:                    | Ветка  |
  |--------------|---------------------------|--------|
  | v1.13.0-awg  | sing-box v1.13.0-alpha.34 | Alpha  |
  | v1.12.14-awg | sing-box v1.12.14               | Stable  |      

Использование достаточно простое:

Сейчас sing-box поддерживает Wireguard как endpoint, форк от Amnezia лишь добавляет новый тип ("type": "awg") в данном endpoint следующей структуры:

Спойлер

 {
    "endpoints": [
      {
        "type": "awg",
        "tag": "awg-ep",

        // Основные параметры
        "useIntegratedTun": false, // если нужен системный тун то true 
        "private_key": "base64-encoded-private-key",
        "address": ["10.0.0.2/32"],  // IP адрес(а) интерфейса
        "mtu": 1280,                  // обычно у amnezia 1280
        "listen_port": 51820,         // тот который на сервере

        // AmneziaWG обфускация 
        "jc": 4,
        "jmin": 50,
        "jmax": 1000,
        "s1": 0,
        "s2": 0,
        "s3": 0,
        "s4": 0,
        "h1": "",
        "h2": "",
        "h3": "",
        "h4": "",
        "i1": "",
        "i2": "",
        "i3": "",
        "i4": "",
        "i5": "",

        // Пиры
        "peers": [
          {
            "address": "server.example.com",  // адрес сервера
            "port": 51820,
            "public_key": "base64-encoded-public-key",
            "preshared_key": "base64-encoded-psk",  // опционально
            "allowed_ips": ["0.0.0.0/0", "::/0"],
            "persistent_keepalive_interval": 25     // опционально, в секундах
          }
        ],

        // Dialer опции (опционально)
        "detour": "",
        "bind_interface": "",
        "routing_mark": 0,
        "connect_timeout": "5s"
      }
    ]
  }

  Ключевые поля:

  
  | useIntegratedTun    | bool       | Использует встроенный TUN вместо внешнего 
  | private_key              | string     | Приватный ключ WireGuard (base64)        
  | address                    | string[]  | IP адрес(а) для интерфейса с маской     
  | mtu                           | uint32    | MTU                 
  | jc, jmin, jmax           | int           | Параметры junk-пакетов Amnezia          
  | s1-s4, h1-h4, i1-i5    | int/string | Дополнительные параметры обфускации     

  Peer:
  
  | address     | string   | Адрес сервера (IP или домен)      
  | port            | uint16   | Порт сервера                      
  | public_key  | string   | Публичный ключ пира (base64)     
  | allowed_ips | string[] | Разрешённые подсети через этот пир

Добавляете этот блок в свою конфигурацию sing-box, заменяете бинарник sing-box и вуаля.

Создавать блок outbound не нужно, tag добавленного endpoint можно использовать напрямую в блоках route.rules или в outbound типа urltest, selector. 

Дополнительно можно использовать настройку  "useIntegratedTun": true тогда будет создан tun интерфейс -  теперь endpoint это как вход так и выход. (если вдруг вам это нужно на роутере)

Спойлер

  При включении useIntegratedTun: true в transport/awg/tun_system.go:31-79 создается системный TUN с жёстко закодированными параметрами:

  singtun, err := tun.New(tun.Options{
      Name: name,                    // автогенерация
      GSO:  true,                    // всегда включен
      MTU:  uint32(mtu),             // из endpoint.mtu
      Inet4Address: ...,             // из endpoint.address
      Inet6Address: ...,             // из endpoint.address
      Inet4RouteAddress: ...,        // из peers[].allowed_ips
      Inet6RouteAddress: ...,        // из peers[].allowed_ips
      Inet4RouteExcludeAddress: ..., // адреса серверов (автоматически)
      Inet6RouteExcludeAddress: ..., // адреса серверов (автоматически)

То есть, использование опции "useIntegratedTun": true  отправляет весь трафик из ОС в туннель. Правила sing-box и его логика работать перестают. 

 

Поскольку ни разу не программист, то профессионалы поправят если что не так или не то  

Главное, что это работает и можно использовать с маршрутизацией самого sing-box по FakeIP.

Еще дополнительно, эта сборка включает amneziawg-go с поддержкой AWG 2.0, что дает следующее:

Спойлер

  Пример конфигурации

  Сервер:
  [Interface]
  S1 = 100
  S2 = 100
  S3 = 50
  S4 = 50
  H1 = 100-200
  H2 = 300-400
  H3 = 500-600
  H4 = 700-800

  Клиент:
  [Interface]
  S1 = 100      # должно совпадать
  S2 = 100      # должно совпадать
  S3 = 50       # должно совпадать
  S4 = 50       # должно совпадать
  H1 = 100-200  # должно совпадать
  H2 = 300-400  # должно совпадать
  H3 = 500-600  # должно совпадать
  H4 = 700-800  # должно совпадать

  # Эти могут отличаться:
  Jc = 8
  Jmin = 40
  Jmax = 800
  I1 = <b 0xaabbccdd><t><r 20>

 

Что должно совпадать

  | Параметр       | Должен совпадать?  | Почему                                                                          |
  |----------------|--------------------|---------------------------------------------------------|
  | S1, S2, S3, S4  | ✅ Да                     | Получатель должен знать размер padding                   |
  | H1, H2, H3, H4 | ✅ Да                     | Получатель должен распознать тип пакета                 |
  | Jc, Jmin, Jmax | ❌ Нет                   | Junk пакеты просто игнорируются                                |
  | I1-I5                   | ❌ Нет                   | Отправляются только клиентом, серверу не важны   |

 

Теги для I1-I5

  | Тег           | Описание                          | Пример           |
  |-----------|---------------------------|----------------|
  | <b 0x...> | Статические байты (hex)   | <b 0xf6ab3267> |
  | <r N>      | Случайные байты                | <r 10>            |
  | <rd N>    | Случайные цифры [0-9]     | <rd 4>           |
  | <rc N>    | Случайные буквы [a-zA-Z]| <rc 8>            |
  | <t>       | Unix timestamp (4 байта)       | <t>                 |
  | <c>       | Счётчик пакетов (4 байта)   | <c>                |

  Важно

  - S3, S4, H1-H4 ranges - новые в AWG 2.0
  - I1-I5 - только на клиенте (сервер их не проверяет)
  - S1, S2, H1-H4 - должны совпадать на клиенте и сервере
  - Jc, Jmin, Jmax - могут различаться

В дополнение, если кому-то будет лениво собирать конфигурацию для amnezia-box самостоятельно, есть вот такой парсер ссылок/файлов AmneziaVPN/WG для этого форка:

https://hoaxisr.github.io/singcraft/

 

Изменено 4 часа назад пользователем hoaxisr

[hoaxisr]

в ходе тестирования данного форка от amnezia дополнительно обнаружил некоторую проблему, а именно реализация amneziawg-go которая подтягивается по умолчанию для сборки предполагает, что вы используете ОДИН endpoint AWG, потому как параметры magic headers являются глобальными. 

Поэтому добавление в конфигурационный файл нескольких endpoint такого типа приводит к ситуации, что его параметры magic headers последнего из них "перебивают" параметры всех предыдущих, что в ситуации когда эти параметры отличаются у endpoint приводит к неработоспособности всех endpoint кроме того для которого magic headers будут валидными на стороне сервера. 

Решение этой проблемы очень простое и добавляет дополнительные возможности - просто использовать amneziawg-go версии 2.0 для чего необходимо включить в go.mod использование вот этого (github.com/amnezia-vpn/amneziawg-go v0.2.17-0.20251219021448-449d7cffd4ad), плюсом этого варианта является поддержка параметров h1-h4 в виде диапазонов значений.

То есть, если вы сами хотите собрать себе sing-box с amneziawg, то внесите изменения в go.mod и собирайте спокойненько себе. 

Изменено 30 декабря, 2025 пользователем hoaxisr