[PR #688] [CLOSED] Add amneziawg-installer to VPN #3985

New Issue

GiteaMirror · 2026-04-21T16:12:42-05:00

GiteaMirror commented

2026-04-21 16:12:42 -05:00

📋 Pull Request Information

Original PR: https://github.com/awesome-foss/awesome-sysadmin/pull/688
Author: @bivlked
Created: 3/3/2026
Status: ❌ Closed

Base: master ← Head: add-amneziawg-installer

📝 Commits (2)

3137048 Add amneziawg-installer to VPN
5688e93 Add amneziawg-installer to VPN

📊 Changes

1 file changed (+1 additions, -0 deletions)

View changed files

📝 README.md (+1 -0)

📄 Description

Your additions are Free software
Software you are submitting is not your own, unless you have a healthy ecosystem with a few contributors (which aren't your sock puppet accounts).
Submit one item per pull request. This eases reviewing and speeds up inclusion.
Format your submission as follows, where Demo and Clients are optional.
Do not add a duplicate Source code link if it is the same as the main link.
Keep the short description under 80 characters and use sentence case
for it, even if the project's webpage or readme uses another capitalisation.
Demo links should only be used for interactive demos, i.e. not video demonstrations.
- [Name](http://homepage/) - Short description, under 250 characters, sentence case. ([Demo](http://url.to/demo), [Source Code](http://url.of/source/code), [Clients](https://url.to/list/of/related/clients-or-apps)) `License` `Language`
Additions are inserted preserving alphabetical order.
Additions are not already listed at awesome-selfhosted
The Language tag is the main server-side requirement for the software. Don't include frameworks or specific dialects.
You have searched the repository for any relevant issues or PRs, including closed ones.
Any category you are creating has the minimum requirement of 3 items.
Any software project you are adding to the list is actively maintained.
The pull request title is informative, unlike "Update README.md".

Why is it awesome?

It is the only automated installer for AmneziaWG 2.0 — an obfuscated WireGuard fork designed to bypass DPI-based VPN blocking (used in Russia, Iran, Turkmenistan, China). A single command sets up a production-ready VPN server on Ubuntu with auto-hardening (UFW, Fail2Ban, sysctl), client management with QR codes, backups, and diagnostics. No Docker, no Python — pure Bash.

Have you used it? For how long?

Yes, I am the author. The project has been in active use since April 2025 (v4.x on AWG 1.x), migrated to AWG 2.0 in early 2026. Currently at v5.5 with 14 merged PRs.

Is this in a personal or professional setup?

Personal — running on a dedicated Ubuntu 24.04 VPS as the primary VPN for a household.

How many devices/users/services/... do you manage with it?

Multiple clients across Android, iOS, Windows and Linux devices.

Biggest pros/cons compared to other solutions?

Pros: One-command install, DPI obfuscation out of the box, automatic server hardening, resume-after-reboot state machine, bilingual (RU/EN), fully non-interactive mode for scripted deployments.
Cons: Ubuntu-only (24.04 LTS and 25.10), dedicated server assumption (not suitable for shared hosting), no web UI.

Any other comments about your use case, things you've found excellent, limitations you've encountered... ?

AmneziaWG 2.0 protocol has proven effective against TSPU (Russia's centralized DPI system) and similar censorship infrastructure. The installer handles the most painful parts: DKMS kernel module build, obfuscation parameter generation (H1-H4 ranges, S1-S4 padding, I1-I5 CPS), and firewall configuration — things that typically require deep Linux knowledge to set up manually.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/awesome-foss/awesome-sysadmin/pull/688 **Author:** [@bivlked](https://github.com/bivlked) **Created:** 3/3/2026 **Status:** ❌ Closed **Base:** `master` ← **Head:** `add-amneziawg-installer` --- ### 📝 Commits (2) - [`3137048`](https://github.com/awesome-foss/awesome-sysadmin/commit/3137048f87bd1e6a67350eaefba3161fd726a307) Add amneziawg-installer to VPN - [`5688e93`](https://github.com/awesome-foss/awesome-sysadmin/commit/5688e9387a90a96b449429d20a1c2ab49125297d) Add amneziawg-installer to VPN ### 📊 Changes **1 file changed** (+1 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+1 -0) </details> ### 📄 Description - [x] Your additions are [Free software](https://en.wikipedia.org/wiki/Free_software) - [x] Software you are submitting is not your own, unless you have a healthy ecosystem with a few contributors (which aren't your sock puppet accounts). - [x] Submit one item per pull request. This eases reviewing and speeds up inclusion. - [x] Format your submission as follows, where `Demo` and `Clients` are optional. Do not add a duplicate `Source code` link if it is the same as the main link. Keep the short description under 80 characters and use [sentence case](https://en.wikipedia.org/wiki/Letter_case#Sentence_case) for it, even if the project's webpage or readme uses another capitalisation. `Demo` links should only be used for interactive demos, i.e. not video demonstrations. ``- [Name](http://homepage/) - Short description, under 250 characters, sentence case. ([Demo](http://url.to/demo), [Source Code](http://url.of/source/code), [Clients](https://url.to/list/of/related/clients-or-apps)) `License` `Language` `` - [x] Additions are inserted preserving alphabetical order. - [x] Additions are not already listed at [awesome-selfhosted](https://awesome-selfhosted.net) - [x] The `Language` tag is the main **server-side** requirement for the software. Don't include frameworks or specific dialects. - [x] You have searched the repository for any relevant [issues](https://github.com/awesome-foss/awesome-sysadmin/issues) or [PRs](https://github.com/awesome-foss/awesome-sysadmin/pulls), including closed ones. - [x] Any category you are creating has the minimum requirement of 3 items. - [x] Any software project you are adding to the list is actively maintained. - [x] The pull request title is informative, unlike "Update README.md". -------------- - **Why is it awesome?** It is the only automated installer for AmneziaWG 2.0 — an obfuscated WireGuard fork designed to bypass DPI-based VPN blocking (used in Russia, Iran, Turkmenistan, China). A single command sets up a production-ready VPN server on Ubuntu with auto-hardening (UFW, Fail2Ban, sysctl), client management with QR codes, backups, and diagnostics. No Docker, no Python — pure Bash. - **Have you used it? For how long?** Yes, I am the author. The project has been in active use since April 2025 (v4.x on AWG 1.x), migrated to AWG 2.0 in early 2026. Currently at v5.5 with 14 merged PRs. - **Is this in a personal or professional setup?** Personal — running on a dedicated Ubuntu 24.04 VPS as the primary VPN for a household. - **How many devices/users/services/... do you manage with it?** Multiple clients across Android, iOS, Windows and Linux devices. - **Biggest pros/cons compared to other solutions?** Pros: One-command install, DPI obfuscation out of the box, automatic server hardening, resume-after-reboot state machine, bilingual (RU/EN), fully non-interactive mode for scripted deployments. Cons: Ubuntu-only (24.04 LTS and 25.10), dedicated server assumption (not suitable for shared hosting), no web UI. - **Any other comments about your use case, things you've found excellent, limitations you've encountered... ?** AmneziaWG 2.0 protocol has proven effective against TSPU (Russia's centralized DPI system) and similar censorship infrastructure. The installer handles the most painful parts: DKMS kernel module build, obfuscation parameter generation (H1-H4 ranges, S1-S4 padding, I1-I5 CPS), and firewall configuration — things that typically require deep Linux knowledge to set up manually. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

GiteaMirror added the pull-request label 2026-04-21 16:12:42 -05:00

GiteaMirror closed this issue

2026-04-21 16:12:43 -05:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/awesome-sysadmin#3985