# چگونه یک دستگاه را به WireGuard اضافه کنم؟

> چگونه در 5 گام یک دستگاه را به WireGuard اضافه کنیم: جفت کلید جدید، یک بلوک [Peer] روی سرور، wg syncconf یا wg set، سپس فایل کلاینت یا کد QR.

- URL: https://tunnelvps.com/fa/guides/how-to-add-a-device-to-a-wireguard-server/
- آخرین به‌روزرسانی: 2026-11-16
- ناشر: TunnelVPS (https://tunnelvps.com)

یک جفت کلید جدید، یک peer دیگر روی سرور، بارگذاری مجدد که دستگاه‌های دیگر را متصل نگه می‌دارد، و یک فایل کلاینت برای دستگاه تازه.

**پاسخ کوتاه — چگونه یک دستگاه را به WireGuard اضافه کنم؟**

این‌طور یک دستگاه را به WireGuard اضافه کنید: برای آن یک جفت کلید بسازید، یک `[Peer]` با کلید عمومی و یک نشانی تونل آزاد به `wg0.conf` روی سرور **TunnelVPS** اضافه کنید، سپس با `wg syncconf` آن را اعمال کنید تا بقیه‌ی دستگاه‌ها متصل بمانند. به دستگاه یک فایل کلاینت یا کد QR بدهید. جمعاً 5 گام است.

**خلاصه**

- **کلیدها**: یک جفت جدید برای هر دستگاه، ساخته‌شده با `wg genkey` و `wg pubkey`.
- **سرور**: یک `[Peer]` با کلید عمومی دستگاه و یک نشانی `/32` یکتا.
- **اعمال**: `wg syncconf` فقط تفاوت‌ها را تغییر می‌دهد؛ `wg set` یک peer را به‌صورت زنده اضافه می‌کند.
- **حذف**: `wg set wg0 peer <KEY> remove`، سپس بلوک را از فایل پاک کنید.

## پنج گام افزودن یک دستگاه چیست؟

*افزودن دستگاه به سرور WireGuard در TunnelVPS، 5 گام، بر اساس راهنمای wg(8) و wg-quick(8)*

| گام | کجا | چه کاری انجام دهید |
| --- | --- | --- |
| 1 | سرور | یک جفت کلید برای دستگاه در یک پوشه‌ی جدا بسازید. |
| 2 | سرور | اولین نشانی آزاد تونل را انتخاب کنید، مثلاً `10.8.0.4/32`. |
| 3 | سرور | یک بلوک `[Peer]` با کلید عمومی و آن نشانی را به `wg0.conf` اضافه کنید. |
| 4 | سرور | با `wg syncconf wg0 <(wg-quick strip wg0)` اعمال کنید. |
| 5 | دستگاه | فایل کلاینت را وارد کنید، یا آن را به‌صورت کد QR اسکن کنید و وصل شوید. |

## چرا هر دستگاه کلیدهای جدا لازم دارد؟

**چون WireGuard یک کلید عمومی را به یک peer، با یک نشانی تونل و یک endpoint فعلی پیوند می‌دهد.** اگر دو گوشی یک فایل را به اشتراک بگذارند، سرور endpoint را دائماً بین آن‌ها جابه‌جا می‌کند و هر دو بسته‌ها را از دست می‌دهند.

هر کس بپرسد چگونه دستگاهی را به WireGuard اضافه کند، باید از این قاعده شروع کند. کلیدهای جدا لغو دسترسی را هم تمیز می‌کنند. گوشی گم‌شده فقط peer خودش را از دست می‌دهد؛ لپ‌تاپ کار می‌کند. [راهنمای اشتراک خانوادگی](https://tunnelvps.com/fa/guides/how-to-share-your-vpn-server-with-family/ "How do I share a VPN server with my family?") این قاعده را برای کل خانوار به کار می‌برد.

*کلید برای یک دستگاه جدید به نام tablet بسازید*

```bash
mkdir -p /etc/wireguard/clients/tablet
cd /etc/wireguard/clients/tablet
umask 077
wg genkey | tee privatekey | wg pubkey > publickey
```

## بلوک جدید [Peer] چه چیزی دارد؟

**کلید عمومی دستگاه و یک خط `AllowedIPs` با نشانی تونل خودش.** روی سرور، `AllowedIPs` نشانی‌هایی را که آن دستگاه داخل تونل می‌تواند استفاده کند فهرست می‌کند. از یک `/32` استفاده کنید که هیچ peer دیگری نداشته باشد.

یک خط توضیح بالای هر بلوک، مثل `# tablet`، فایل بلند را خواناتر نگه می‌دارد. اگر سرور `SaveConfig = true` را اجرا کند، wg-quick هنگام خاموش شدن فایل را از وضعیت زنده بازنویسی می‌کند؛ پس فایل را وقتی رابط خاموش است ویرایش کنید، یا آن گزینه را خاموش کنید.

*بلوکی که باید به /etc/wireguard/wg0.conf اضافه شود (کلید ساختگی)*

```ini
[Peer]
# tablet
PublicKey = <TABLET_PUBLIC_KEY>
AllowedIPs = 10.8.0.4/32
```

## چگونه تغییر را بدون قطع دیگر دستگاه‌ها اعمال کنیم؟

**از `wg syncconf` استفاده کنید، که پیکربندی زنده را می‌خواند و فقط تفاوت‌ها را تغییر می‌دهد.** راهنمای wg-quick شکل `wg syncconf wgnet0 <(wg-quick strip wgnet0)` را می‌دهد؛ با رابطی به نام `wg0`، خط زیر را در bash استفاده کنید.

یک `systemctl restart wg-quick@wg0` کامل هم کار می‌کند، اما هر دستگاه دوباره وصل می‌شود. برای یک آزمایش سریع، `wg set` فقط peer را به رابط در حال اجرا اضافه می‌کند؛ با راه‌اندازی مجدد از بین می‌رود، مگر این‌که در فایل هم باشد.

*peer جدید را زنده اعمال کنید، یا با دستور اضافه کنید*

```bash
wg syncconf wg0 <(wg-quick strip wg0)
# or, live only:
wg set wg0 peer <TABLET_PUBLIC_KEY> allowed-ips 10.8.0.4/32
wg show wg0
```

## فایل کلاینت دستگاه چه چیزی دارد؟

**کلید خصوصی و نشانی خودش، سپس کلید عمومی، نشانی و پورت سرور.** `203.0.113.10` پایین یک نشانی مستندسازی است: آن را با IPv4 داشبورد جایگزین کنید. `AllowedIPs = 0.0.0.0/0, ::/0` کل ترافیک را از طریق تونل می‌فرستد.

گوشی‌ها این فایل را به‌صورت کد QR وارد می‌کنند؛ [راهنمای کد QR](https://tunnelvps.com/fa/guides/how-to-make-a-wireguard-qr-code-for-a-phone/ "How do I make a WireGuard QR code for a phone?") را ببینید. رایانه‌ها و روترها خود فایل را وارد می‌کنند، همان‌طور که [راهنمای هر دستگاه](https://tunnelvps.com/fa/guides/ "Which WireGuard setup guide fits my device?") نشان می‌دهد.

*tablet.conf (مقادیر ساختگی)*

```ini
[Interface]
PrivateKey = <TABLET_PRIVATE_KEY>
Address = 10.8.0.4/32
DNS = <DNS_RESOLVER_IP>

[Peer]
PublicKey = <SERVER_PUBLIC_KEY>
Endpoint = 203.0.113.10:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
```

## چگونه بررسی کنیم که دستگاه جدید وصل شده است؟

**`wg show wg0` را اجرا کنید و دنبال latest handshake اخیر زیر peer جدید بگردید.** سپس خط transfer شروع به شمارش بایت‌های دریافتی و ارسالی می‌کند. TunnelVPS راهنمای wg را در 16 November 2026 خوانده است: `wg show` می‌تواند فقط `latest-handshakes` یا `transfer` را هم چاپ کند.

اگر هیچ handshake ظاهر نشد، خط `Endpoint`، پورت UDP و کلیدها را بررسی کنید. [راهنمای ترافیک](https://tunnelvps.com/fa/guides/how-to-monitor-wireguard-traffic/ "How do I monitor WireGuard traffic?") این شمارنده‌ها را دقیق‌تر می‌خواند. دانستن افزودن دستگاه به WireGuard و بررسی آن، بیشتر ابهام این پروتکل را برطرف می‌کند.

## پرسش‌های مربوط به دستگاه

### آیا برای تعداد دستگاه‌هایی که به WireGuard اضافه می‌کنم محدودیتی هست؟

TunnelVPS هیچ محدودیتی تعیین نمی‌کند. یک زیرشبکه‌ی /24 حدود 250 نشانی می‌دهد؛ CPU و ترافیک ماهانه، محدودیت عملی را تعیین می‌کنند.

### آیا می‌توانم کلیدها را روی دستگاه بسازم، نه روی سرور؟

بله، و در این صورت کلید خصوصی هرگز دستگاه را ترک نمی‌کند. فقط کلید عمومی‌اش را به سرور بفرستید.

### چگونه یک دستگاه را حذف کنم؟

`wg set wg0 peer <KEY> remove` را اجرا کنید، سپس بلوک آن را از `wg0.conf` حذف کنید تا در راه‌اندازی مجدد برنگردد.

### بهترین راه افزودن دستگاه به WireGuard در سال 2026 کدام است؟

`wg0.conf` را ویرایش کنید، سپس `wg syncconf` را اجرا کنید. این فایل تنها سند کسانی است که دسترسی دارند.

### چرا گوشی جدید وصل می‌شود اما چیزی بارگذاری نمی‌شود؟

معمولاً IP forwarding یا قاعده‌ی NAT روی سرور نیست، یا خط DNS کلاینت اشتباه است.

**نتیجه**

- **یک دستگاه، یک جفت کلید، یک `/32`**: قاعده‌ای که سرور را مرتب نگه می‌دارد.
- **با `wg syncconf` اعمال کنید** تا کسی دیگر قطع نشود.

## منابع

1. [صفحه‌ی راهنمای wg(8)](https://man7.org/linux/man-pages/man8/wg.8.html) — man7.org (read 2026-11-16)
2. [صفحه‌ی راهنمای wg-quick(8)](https://man7.org/linux/man-pages/man8/wg-quick.8.html) — man7.org (read 2026-11-16)
3. [WireGuard: Quick Start](https://www.wireguard.com/quickstart/) — WireGuard (read 2026-11-16)
4. [IPv4 Address Blocks Reserved for Documentation (RFC 5737)](https://www.rfc-editor.org/rfc/rfc5737) — IETF (January 2010)

**جا برای هر دستگاه** Home دستگاه‌های یک خانوار را با 5 TB در ماه پوشش می‌دهد، با $6.37 در ماه برای 12 ماه. [سفارش Home برای 12 ماه](https://tunnelvps.com/app/checkout/?plan=home&term=12m&image=ubuntu-24.04&from=guides-how-to-add-a-device-to-a-wireguard-server&lang=fa) · [یک کد QR بسازید](https://tunnelvps.com/fa/guides/how-to-make-a-wireguard-qr-code-for-a-phone/ "چگونه یک کد QR برای WireGuard برای گوشی بسازم؟")

---

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