# چگونه wg-easy را روی یک VPS نصب کنم؟

> نصب wg-easy روی یک VPS در 6 گام: Docker، فایل compose رسمی، docker compose up، پورت 51820/udp، و یک صفحه‌ی مدیریت وب محافظت‌شده.

- URL: https://tunnelvps.com/fa/guides/how-to-install-wg-easy-on-a-vps/
- آخرین به‌روزرسانی: 2026-11-16
- ناشر: TunnelVPS (https://tunnelvps.com)

wg-easy، WireGuard را در Docker با یک صفحه‌ی وب برای کلاینت‌ها و کدهای QR اجرا می‌کند. نصب چهار دستور است؛ بخش حساس محافظت از صفحه‌ی مدیریت است.

**پاسخ کوتاه — چگونه wg-easy را روی یک VPS نصب کنم؟**

این‌طور wg-easy را روی یک VPS نصب کنید: با root به سرور **TunnelVPS** وارد شوید، Docker را با اسکریپت رسمی نصب کنید، فایل `docker-compose.yml` پروژه را در `/etc/docker/containers/wg-easy` دانلود کنید، و `docker compose up -d` را اجرا کنید. سپس WireGuard روی UDP 51820 گوش می‌دهد. پیش از دسترسی از اینترنت، صفحه‌ی مدیریت وب را پشت یک reverse proxy قرار دهید.

**خلاصه**

- **چیست**: WireGuard به‌همراه صفحه‌ی مدیریت وب برای کلاینت‌ها و کدهای QR، در Docker، تحت AGPL-3.0.
- **نصب**: Docker، سپس فایل compose رسمی و `docker compose up -d`.
- **پورت**: UDP 51820 برای WireGuard، که در فایل compose قابل تغییر است.
- **صفحه‌ی مدیریت**: یک reverse proxy برای دسترسی از اینترنت؛ مستندات HTTP ساده را ناامن می‌داند.

## گام‌های نصب wg-easy چیست؟

*نصب wg-easy روی سرور TunnelVPS، 6 گام، بر اساس مستندات wg-easy خوانده‌شده در 16 November 2026*

| گام | کجا | چه کاری انجام دهید |
| --- | --- | --- |
| 1 | پرداخت TunnelVPS | یک سرور با تصویر Debian یا Ubuntu و کلید SSH خود سفارش دهید. |
| 2 | سرور، با root | Docker را با `curl -sSL https://get.docker.com \| sh` نصب کنید، سپس دوباره وارد شوید. |
| 3 | سرور | `/etc/docker/containers/wg-easy` را بسازید و `docker-compose.yml` را در آن دانلود کنید. |
| 4 | سرور | `docker compose up -d` را در آن پوشه اجرا کنید. |
| 5 | فایروال سرور | اگر فایروال اجرا می‌شود، UDP 51820 یا پورتی را که تنظیم کرده‌اید باز کنید. |
| 6 | Reverse proxy | صفحه‌ی مدیریت را روی HTTPS منتشر کنید، یا آن را از اینترنت دور نگه دارید. |

## چرا به‌جای WireGuard ساده از wg-easy استفاده کنیم؟

**چون افزودن، غیرفعال کردن و به اشتراک گذاشتن کلاینت‌ها با چند کلیک روی یک صفحه‌ی وب انجام می‌شود.** wg-easy هر کلاینت و یک کد QR برای گوشی‌ها را نشان می‌دهد. WireGuard ساده همین کار را با فایل‌های پیکربندی و `qrencode` انجام می‌دهد.

بده‌بستان این است که یک سرویس وب باید محافظت شود، و Docker هم باید به‌روز نگه داشته شود. برای دو یا سه دستگاه، WireGuard ساده با [نصب یک‌دستوری](https://tunnelvps.com/fa/help/install-wireguard-in-one-command/ "How do I install WireGuard on a TunnelVPS server?") سبک‌تر می‌ماند. برای تیمی با peerهای زیاد، پنل وقت را ذخیره می‌کند؛ به همین دلیل مردم اصلاً می‌پرسند چگونه wg-easy را روی یک VPS نصب کنند.

## چگونه Docker را نصب کنیم و wg-easy را راه بیندازیم؟

**اسکریپت نصب Docker را اجرا کنید، سپس چهار دستور صفحه‌ی نصب پایه‌ی wg-easy را بزنید.** TunnelVPS آن صفحه را در 16 November 2026 خوانده است. صفحه‌ی GitHub می‌گوید اسکریپت Docker را با root اجرا کنید و پس از آن دوباره وارد شوید.

دستورهای زیر همان دستورهای رسمی هستند و تغییری در آن‌ها داده نشده است. آن‌ها از `sudo` استفاده می‌کنند که وقتی از قبل root هستید بی‌ضرر است. همین برای یادگیری نحوه‌ی نصب wg-easy روی یک VPS کافی است؛ بقیه‌اش پیکربندی است.

*Docker و سپس wg-easy را نصب کنید (دستورهای رسمی)*

```bash
curl -sSL https://get.docker.com | sh
# log out and back in, then:
sudo mkdir -p /etc/docker/containers/wg-easy
sudo curl -o /etc/docker/containers/wg-easy/docker-compose.yml https://raw.githubusercontent.com/wg-easy/wg-easy/master/docker-compose.yml
cd /etc/docker/containers/wg-easy
sudo docker compose up -d
```

## wg-easy به کدام پورت‌ها نیاز دارد؟

**UDP 51820 برای WireGuard، طبق صفحه‌ی نصب پایه.** مستندات می‌گوید پورت‌ها قابل تغییرند و فایروال باید از این تغییر پیروی کند. پورت‌های UDP و TCP ورودی روی سرور باز است؛ مشتری پورت VPN را انتخاب می‌کند و فایروال را تنظیم می‌کند.

پورت صفحه‌ی مدیریت در فایل compose تنظیم می‌شود. آن را بدون محافظت به کل اینترنت باز نکنید. [راهنمای پورت UFW](https://tunnelvps.com/fa/guides/how-to-open-the-wireguard-port-in-ufw/ "How do I open the WireGuard port in UFW?") نشان می‌دهد چگونه فقط پورت WireGuard را باز کنید.

## صفحه‌ی مدیریت وب چگونه باید محافظت شود؟

**پشت یک reverse proxy با HTTPS، که مستندات wg-easy توصیه می‌کند.** مستندات راهنماهایی برای Traefik و Caddy ارائه می‌دهد.

یک حالت بدون proxy هم وجود دارد: `INSECURE=true` را در `environment` فایل compose تنظیم کنید. مستندات این را ناامن می‌داند و می‌گوید فقط اگر می‌دانید چه می‌کنید از آن استفاده کنید. همچنین می‌گویند باید مطمئن شوید صفحه از بیرون شبکه‌ی محلی شما قابل دسترسی نیست. روی یک VPS شبکه‌ی محلی‌ای وجود ندارد، پس proxy را الزامی بدانید.

*تنظیم بدون proxy از مستندات (ناامن، روی یک VPS عمومی پرهیز شود)*

```yaml
environment:
  - INSECURE=true
```

## کدام طرح برای wg-easy و یک تیم کوچک مناسب است؟

**Crew برای یک پنل وب مانند wg-easy، چند پروتکل و peerهای زیاد اندازه شده است.** 4 shared vCPU, 8 GB RAM, 120 GB NVMe, 5 TB a month دارد، برای $10.12 در ماه برای 12 ماه، و قابل اجاره‌ی ماه‌به‌ماه است.

Docker حافظه‌ی بیشتری روی WireGuard مصرف می‌کند، پس Home (4 GB RAM) کوچک‌ترین انتخاب راحت است. [صفحه‌ی سرور برای تیم کوچک](https://tunnelvps.com/fa/best-vpn-server-for-a-small-team/ "What is the best VPN server for a small team?") گزینه‌ها را بر اساس تعداد نفرات مقایسه می‌کند.

## پرسش‌های wg-easy

### آیا wg-easy رایگان است؟

بله. متن‌باز است و تحت مجوز AGPL-3.0 منتشر شده است. سرور تنها هزینه است.

### آیا wg-easy و یک راه‌اندازی دستی WireGuard می‌توانند روی یک سرور اجرا شوند؟

فقط روی پورت‌ها و نام رابط‌های متفاوت. اجرای دو مدیر WireGuard روی یک پورت شکست می‌خورد، پس یکی را انتخاب کنید.

### wg-easy را چگونه به‌روز کنم؟

مراحل به‌روزرسانی را در مستندات wg-easy برای نسخه‌ی خود دنبال کنید؛ آن‌ها با Docker Compose یک تصویر جدیدتر را دریافت می‌کنند.

### آیا wg-easy کد QR برای گوشی‌ها می‌سازد؟

بله. صفحه‌ی وب هر کلاینت را با یک کد QR نشان می‌دهد که برنامه‌ی گوشی WireGuard می‌تواند آن را اسکن کند.

### بهترین راه نصب wg-easy روی یک VPS در سال 2026 کدام است؟

مسیر رسمی Docker Compose از مستندات wg-easy، با یک reverse proxy جلوی صفحه‌ی مدیریت.

**نتیجه**

- **چهار دستور wg-easy را نصب می‌کنند**؛ Docker اول می‌آید.
- **هرگز صفحه‌ی مدیریت را روی HTTP ساده باز نگذارید** روی یک سرور عمومی.

## منابع

1. [مخزن wg-easy](https://github.com/wg-easy/wg-easy) — GitHub (read 2026-11-16)
2. [wg-easy: نصب پایه](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/basic-installation/) — wg-easy (read 2026-11-16)
3. [wg-easy: بدون reverse proxy](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/reverse-proxyless/) — wg-easy (read 2026-11-16)
4. [WireGuard: نصب](https://www.wireguard.com/install/) — WireGuard (read 2026-11-16)

**یک سرور برای wg-easy بگیرید** Home حافظه‌ی لازم برای Docker و WireGuard را دارد، در ماه $6.37 برای 12 ماه. [سفارش Home برای 12 ماه](https://tunnelvps.com/app/checkout/?plan=home&term=12m&image=ubuntu-24.04&from=guides-how-to-install-wg-easy-on-a-vps&lang=fa) · [افزودن یک دستگاه به WireGuard](https://tunnelvps.com/fa/guides/how-to-add-a-device-to-a-wireguard-server/ "چگونه یک دستگاه را به WireGuard اضافه کنم؟")

---

TunnelVPS: TunnelVPS سرورهای KVM لینوکس را برای VPN شخصی (WireGuard، Outline یا AmneziaWG) در نیویورک، دالاس، لس‌آنجلس، لندن، آمستردام و فرانکفورت اجاره می‌دهد؛ پرداخت با ارز دیجیتال و بدون مدرک هویت. ۵ طرح از ۲ تا ۱۶ گیگابایت رم و ۲ تا ۶ ترابایت ترافیک در ماه، در هر شش شهر یک قیمت دارند؛ در دوره‌ی ۱۲ ماهه، هر طرح دست‌کم ۲۵٪ ارزان‌تر از یک طرح مشابه نام‌برده‌شده‌ی یک میزبان ارز دیجیتالی بدون KYC است، با بررسی در 16 November 2026. بهره‌بردار DomaineGoat LLC در پاناما است.
