Skip to content

Add AmneziaWG protocol support#6

Merged
quyxishi merged 19 commits into
quyxishi:mainfrom
nsvk13:main
Dec 22, 2025
Merged

Add AmneziaWG protocol support#6
quyxishi merged 19 commits into
quyxishi:mainfrom
nsvk13:main

Conversation

@nsvk13

@nsvk13 nsvk13 commented Dec 22, 2025

Copy link
Copy Markdown
Contributor

Implements support for AmneziaWG (obfuscated WireGuard) to enable VPN probing in censored regions where standard WireGuard is blocked.

Changes

  • Dependency: Use amnezia-vpn/amnezia-xray-core v1.8.16 (fork with AWG support)
  • Protocol scheme: Add awg:// URI scheme support
  • Parser: Implement AWG INI config parser with obfuscation parameters
  • Integration: Wire up AWG through xray-core's WireGuard protocol with obfuscation
  • Tests: Add TestParseURI_AmneziaWG with full parameter coverage
  • Example: Add AWG configuration to whitebox-sd-config.yml

Implementation Details

AWG uses the standard "wireguard" protocol in xray-core with additional obfuscation parameters:

  • Jc (0-128): Junk packet count
  • Jmin/Jmax (0-1280): Junk packet size range
  • S1/S2: Init/Response packet junk sizes
  • H1-H4: Magic headers for packet obfuscation

Testing

# Unit tests
go test ./internal/serial/... -v -run TestParseURI_AmneziaWG

# API test
curl "http://localhost:9116/probe?ctx=awg%3A%2F%2F<base64_config>&target=https://google.com"

nsvk13 and others added 19 commits December 8, 2025 14:14
@nsvk13
feat(extra): add awg scheme constant
0f97c76
@nsvk13
feat(extra): add AmneziaWGInner field to ConnectionExtra
40449e2
@nsvk13
feat(protocol): add AmneziaWG outbound parser
f13d98a
@nsvk13
feat(xray): handle awg URI parsing
bcc09c8
@nsvk13
feat(stream): add AmneziaWG case to ParseStreamConfig
532d2c5
@nsvk13
chore(deps): switch to amnezia-xray-core for awg support
4a530dc
@nsvk13
test: add AmneziaWG URI parsing test
da0d56d
@nsvk13
docs(examples): add AmneziaWG configuration example
f1f8387
@nsvk13
fix(deps): correct amnezia-xray-core version and imports
ee04f7c
@nsvk13
Merge branch 'quyxishi:main' into main
49f5901
@nsvk13
del
57c51d6
@nsvk13
Merge branch 'main' of https://github.com/nsvk13/whitebox
116c297
@nsvk13
docs: update bullet
e9bf837
@nsvk13
fix(awg)!: finalize AmneziaWG integration with correct dependencies
58f9e3c
@quyxishi
fix(deps): resolve broken dependencies:
3fe6f38 
- sagernet/sing v0.5.1 => v0.4.1
- quic-go/quic-go/logging v0.44.0
- gin-gonic/gin v1.11.0 => v1.10.1
- quic-go/quic-go v0.57.0 => v0.44.0
- quic-go/quic-go/qlog v0.44.0
- gvisor.dev/gvisor v0.0.0-20250828211149-1f30edfbb5d4 => v0.0.0-20231202080848-1f7806d17489
@quyxishi
chore(deps): update std tooling dependencies that will not break
f801b59
@quyxishi
style(docs): adjust docs style and extend targets in readme
110a395
@quyxishi
style: go fmt w/ manual adjustments
272bb5f
@quyxishi
chore(deps): upd amnezia-xray-core => v1.8.16
0542124 
finally resolved local issues with deps
@quyxishi quyxishi self-requested a review December 22, 2025 17:30
@quyxishi quyxishi merged commit 12c29c6 into quyxishi:main Dec 22, 2025
4 checks passed
@quyxishi quyxishi added the feature New feature or request label Dec 22, 2025
@quyxishi

quyxishi commented Dec 22, 2025

Copy link
Copy Markdown
Owner

Thanks for the PR and the solid work on whitebox - appreciate that.

@nsvk13

nsvk13 commented Dec 22, 2025

Copy link
Copy Markdown
Contributor Author

Thanks for the PR and the solid work on whitebox - appreciate that.

Happy to help, and thank you for the project. I truly appreciate the opportunity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@quyxishi quyxishi quyxishi approved these changes

Assignees

No one assigned

Labels

feature New feature or request

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@nsvk13 @quyxishi