پاسخ کوتاه
چگونه یک کد 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 چیست؟
| گام | کجا | چه کاری انجام دهید |
|---|---|---|
| 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 و راهنمای Android صفحهی اسکن هر برنامه را نشان میدهند.
qrencode فایل را چگونه به یک کد تبدیل میکند؟
اگر رشتهای داده نشود، متن را از ورودی استاندارد میخواند و آن را در نوع خروجیای که با -t انتخاب شده رسم میکند. TunnelVPS راهنمای qrencode را در 16 November 2026 خوانده است. انواع شامل PNG (پیشفرض)، UTF8 و ANSIUTF8 است.
ANSIUTF8 برای بیشتر ترمینالها مناسب است: از نویسههای بلوکی و کدهای رنگ استفاده میکند. اگر کد خراب به نظر رسید، پنجره را پهنتر کنید یا -t UTF8 را امتحان کنید. علامت < فایل را به دستور میدهد.
apt install qrencode
cd /etc/wireguard/clients
qrencode -t ANSIUTF8 < phone.conf
# after the scan:
clearآیا میتوانم کد را بهجای آن بهصورت تصویر ذخیره کنم؟
بله: -o کد را در یک فایل مینویسد و PNG نوع پیشفرض است. این وقتی مفید است که گوشی کنار رایانهای نیست که نشست SSH روی آن اجرا میشود. نسخهی PNG را با scp پایین بکشید، روی صفحه نشانش دهید، اسکن کنید، سپس هر دو نسخه را پاک کنید.
هرگز آن تصویر را جایی منتشر نکنید. هرکس از آن عکس بگیرد میتواند با آن گوشی وصل شود، تا وقتی peer آن از سرور حذف شود.
qrencode -o /root/phone.png < /etc/wireguard/clients/phone.conf
# copy it down from your computer:
# scp [email protected]:/root/phone.png .
rm /root/phone.pngپیش از رمزگذاری، چه چیزی باید در فایل باشد؟
یک پیکربندی کامل کلاینت: نشانی و کلید خصوصی گوشی، سپس کلید عمومی و endpoint سرور. نبود Endpoint یا کلید اشتباه، تونلی میدهد که وارد میشود اما هرگز دستدادن برقرار نمیکند.
راهنمای افزودن دستگاه آن فایل و [Peer] متناظر را روی سرور میسازد. کد QR برای WireGuard را فقط پس از زنده شدن peer بسازید تا گوشی بیدرنگ آن را آزمایش کند.
آیا گزینهی کد QR برای WireGuard بدون ترمینال وجود دارد؟
بله: wg-easy کد QR هر کلاینت را روی صفحهی وبش نشان میدهد. برای سروری که بسیاری از افراد با هم استفاده میکنند مناسب است. هزینهاش یک صفحهی مدیریت وب است که باید محافظت شود.
راهنمای نصب wg-easy آن را پوشش میدهد. برای چند گوشی، qrencode در پنجرهی SSH سریعتر است و هیچ سرویس تازهای به سرور اضافه نمیکند.
پرسشهای کد QR
آیا کد QR برای WireGuard کلید خصوصی را دارد؟
بله. کل فایل کلاینت، از جمله کلید خصوصی، را دارد. مانند گذرواژه با آن رفتار کنید.
آیا یک کد QR را میتوان روی دو گوشی استفاده کرد؟
میتوان آن را دو بار اسکن کرد، اما آنگاه هر دو گوشی یک peer را شریکاند و یکدیگر را قطع میکنند. برای هر گوشی یک کد بسازید.
بهترین راه ساختن کد QR برای WireGuard در سال 2026 کدام است؟
qrencode -t ANSIUTF8 در نشست SSH: کلید هرگز کانال رمزگذاریشده را ترک نمیکند.
آیا یک لپتاپ میتواند کد را اسکن کند؟
برنامههای دسکتاپ بهجای آن فایل .conf را وارد میکنند. آن را با scp کپی کنید، همانطور که هر راهنمای دستگاه نشان میدهد.
کد برای ترمینال من خیلی بزرگ است. حالا چه کنم؟
پنجره را بزرگ کنید یا اندازهی قلم را کم کنید، یا با -o یک PNG بنویسید و پس از اسکن پاکش کنید.
نتیجه
qrencode -t ANSIUTF8 < phone.confسریعترین راه برای رساندن یک تونل به گوشی است.- صفحه را پاک کنید و نسخههای PNG را حذف کنید: کد یک کلید است.
منابع (3)
- صفحهی راهنمای qrencode(1) — Debian (read 2026-11-16)
- WireGuard: نصب و برنامههای کلاینت — WireGuard (read 2026-11-16)
- مخزن wg-easy — GitHub (read 2026-11-16)
یک سرور برای هر گوشی در خانه
Home یک خانوار از گوشیها را با 5 TB در ماه پوشش میدهد، با $6.37 در ماه برای 12 ماه.
- ساختهشده توسط یک نفر، حداکثر ۱ ساعت پس از تأیید
- در صورت عدم تحویل سرور، روزهای از دسترفته به موجودی بازمیگردد
- پرداخت با BTC، XMR، USDT، USDC، ETH، SOL یا LTC
- DomaineGoat LLC · پاناما