# چگونه یک کد QR برای WireGuard برای گوشی بسازم؟

> در 4 گام یک کد QR برای WireGuard برای گوشی بسازید: نصب qrencode، چاپ فایل کلاینت در ترمینال SSH، اسکن آن، سپس پاک کردن کلید خصوصی.

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

فایل کلاینت گوشی، به‌صورت کد QR در همان پنجره‌ی SSH چاپ می‌شود، توسط برنامه‌ی WireGuard اسکن می‌شود، و پس از آن چیزی باقی نمی‌ماند.

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

برای ساختن کد QR برای WireGuard، `qrencode` را روی سرور **TunnelVPS** نصب کنید و `qrencode -t ANSIUTF8 < phone.conf` را در ترمینال SSH اجرا کنید. فایل کلاینت گوشی به‌صورت یک کد روی صفحه ظاهر می‌شود. آن را از برنامه‌ی WireGuard روی iPhone یا Android اسکن کنید، سپس ترمینال را پاک کنید. 4 گام است و کمتر از یک دقیقه طول می‌کشد.

**خلاصه**

- **ابزار**: `qrencode`، با apt روی Debian یا Ubuntu نصب می‌شود.
- **کد ترمینال**: `-t ANSIUTF8` کد را با نویسه‌های متنی رسم می‌کند.
- **تصویر**: `-o phone.png` یک PNG می‌نویسد، که نوع خروجی پیش‌فرض است.
- **ایمنی**: کد کلید خصوصی گوشی را دارد؛ پس از اسکن پاکش کنید.

## 4 گام ساختن کد QR چیست؟

*کد QR برای WireGuard برای گوشی از یک سرور TunnelVPS، 4 گام، بر اساس راهنمای qrencode(1)*

| گام | کجا | چه کاری انجام دهید |
| --- | --- | --- |
| 1 | سرور | ابزار را با `apt install qrencode` نصب کنید. |
| 2 | سرور | فایل کلاینت گوشی را بنویسید، برای مثال `/etc/wireguard/clients/phone.conf`. |
| 3 | ترمینال SSH | `qrencode -t ANSIUTF8 < phone.conf` را اجرا کنید و کد را از برنامه‌ی WireGuard اسکن کنید. |
| 4 | ترمینال SSH | `clear` را اجرا کنید، و هر نسخه‌ی PNG از کد را پاک کنید. |

## چرا به‌جای فایل، از کد QR برای WireGuard استفاده کنیم؟

**چون یک گوشی راه ساده‌ای برای دریافت فایل پیکربندی از طریق SSH ندارد، اما دوربینش کد را در یک ثانیه می‌خواند.** برنامه‌های WireGuard برای iOS و Android هر دو یک تونل را از کد QR وارد می‌کنند.

کد، کل فایل کلاینت است به شکلی دیگر. از طریق ایمیل، گفت‌وگو یا درایو ابری چیزی منتقل نمی‌شود. [راهنمای iPhone](https://tunnelvps.com/fa/guides/wireguard-iphone/ "How do I set up WireGuard on an iPhone?") و [راهنمای Android](https://tunnelvps.com/fa/guides/wireguard-android/ "How do I set up WireGuard on Android?") صفحه‌ی اسکن هر برنامه را نشان می‌دهند.

## qrencode فایل را چگونه به یک کد تبدیل می‌کند؟

**اگر رشته‌ای داده نشود، متن را از ورودی استاندارد می‌خواند و آن را در نوع خروجی‌ای که با `-t` انتخاب شده رسم می‌کند.** TunnelVPS راهنمای qrencode را در 16 November 2026 خوانده است. انواع شامل PNG (پیش‌فرض)، UTF8 و ANSIUTF8 است.

ANSIUTF8 برای بیشتر ترمینال‌ها مناسب است: از نویسه‌های بلوکی و کدهای رنگ استفاده می‌کند. اگر کد خراب به نظر رسید، پنجره را پهن‌تر کنید یا `-t UTF8` را امتحان کنید. علامت `<` فایل را به دستور می‌دهد.

*qrencode را نصب کنید و فایل گوشی را به‌صورت کد چاپ کنید*

```bash
apt install qrencode
cd /etc/wireguard/clients
qrencode -t ANSIUTF8 < phone.conf
# after the scan:
clear
```

## آیا می‌توانم کد را به‌جای آن به‌صورت تصویر ذخیره کنم؟

**بله: `-o` کد را در یک فایل می‌نویسد و PNG نوع پیش‌فرض است.** این وقتی مفید است که گوشی کنار رایانه‌ای نیست که نشست SSH روی آن اجرا می‌شود. نسخه‌ی PNG را با `scp` پایین بکشید، روی صفحه نشانش دهید، اسکن کنید، سپس هر دو نسخه را پاک کنید.

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

*کد را به PNG بنویسید، سپس پس از اسکن پاکش کنید*

```bash
qrencode -o /root/phone.png < /etc/wireguard/clients/phone.conf
# copy it down from your computer:
#   scp root@203.0.113.10:/root/phone.png .
rm /root/phone.png
```

## پیش از رمزگذاری، چه چیزی باید در فایل باشد؟

**یک پیکربندی کامل کلاینت: نشانی و کلید خصوصی گوشی، سپس کلید عمومی و endpoint سرور.** نبود `Endpoint` یا کلید اشتباه، تونلی می‌دهد که وارد می‌شود اما هرگز دست‌دادن برقرار نمی‌کند.

[راهنمای افزودن دستگاه](https://tunnelvps.com/fa/guides/how-to-add-a-device-to-a-wireguard-server/ "How do I add a device to WireGuard?") آن فایل و `[Peer]` متناظر را روی سرور می‌سازد. کد QR برای WireGuard را فقط پس از زنده شدن peer بسازید تا گوشی بی‌درنگ آن را آزمایش کند.

## آیا گزینه‌ی کد QR برای WireGuard بدون ترمینال وجود دارد؟

**بله: wg-easy کد QR هر کلاینت را روی صفحه‌ی وبش نشان می‌دهد.** برای سروری که بسیاری از افراد با هم استفاده می‌کنند مناسب است. هزینه‌اش یک صفحه‌ی مدیریت وب است که باید محافظت شود.

[راهنمای نصب wg-easy](https://tunnelvps.com/fa/guides/how-to-install-wg-easy-on-a-vps/ "How do I install wg-easy on a VPS?") آن را پوشش می‌دهد. برای چند گوشی، `qrencode` در پنجره‌ی SSH سریع‌تر است و هیچ سرویس تازه‌ای به سرور اضافه نمی‌کند.

## پرسش‌های کد QR

### آیا کد QR برای WireGuard کلید خصوصی را دارد؟

بله. کل فایل کلاینت، از جمله کلید خصوصی، را دارد. مانند گذرواژه با آن رفتار کنید.

### آیا یک کد QR را می‌توان روی دو گوشی استفاده کرد؟

می‌توان آن را دو بار اسکن کرد، اما آنگاه هر دو گوشی یک peer را شریک‌اند و یکدیگر را قطع می‌کنند. برای هر گوشی یک کد بسازید.

### بهترین راه ساختن کد QR برای WireGuard در سال 2026 کدام است؟

`qrencode -t ANSIUTF8` در نشست SSH: کلید هرگز کانال رمزگذاری‌شده را ترک نمی‌کند.

### آیا یک لپ‌تاپ می‌تواند کد را اسکن کند؟

برنامه‌های دسکتاپ به‌جای آن فایل `.conf` را وارد می‌کنند. آن را با `scp` کپی کنید، همان‌طور که هر راهنمای دستگاه نشان می‌دهد.

### کد برای ترمینال من خیلی بزرگ است. حالا چه کنم؟

پنجره را بزرگ کنید یا اندازه‌ی قلم را کم کنید، یا با `-o` یک PNG بنویسید و پس از اسکن پاکش کنید.

**نتیجه**

- **`qrencode -t ANSIUTF8 < phone.conf`** سریع‌ترین راه برای رساندن یک تونل به گوشی است.
- **صفحه را پاک کنید و نسخه‌های PNG را حذف کنید**: کد یک کلید است.

## منابع

1. [صفحه‌ی راهنمای qrencode(1)](https://manpages.debian.org/bookworm/qrencode/qrencode.1.en.html) — Debian (read 2026-11-16)
2. [WireGuard: نصب و برنامه‌های کلاینت](https://www.wireguard.com/install/) — WireGuard (read 2026-11-16)
3. [مخزن wg-easy](https://github.com/wg-easy/wg-easy) — GitHub (read 2026-11-16)

**یک سرور برای هر گوشی در خانه** 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-make-a-wireguard-qr-code-for-a-phone&lang=fa) · [راه‌اندازی iPhone](https://tunnelvps.com/fa/guides/wireguard-iphone/ "چگونه WireGuard را روی iPhone راه‌اندازی کنم؟")

---

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