برای ارائه‌دهندگان VPN

Piko به هیچ ارائه‌دهنده‌ای وابسته نیست. سازگاری با Piko به معنای تأیید نیست و ما ارائه‌دهندگان را فهرست یا پیشنهاد نمی‌کنیم.

پیوندهای «افزودن به Piko»

دکمه‌ای در سایت، ربات یا ایمیل‌هایتان بگذارید که Piko را باز کند و اشتراک را اضافه کند. Piko همیشه پیش از ذخیرهٔ هر چیزی یک صفحهٔ تأیید نشان می‌دهد.

piko://install-sub?url=https%3A%2F%2Fsub.example.com%2Fs%2Fabc123&name=Example

url: نشانی اشتراک، با کدگذاری درصدی (percent-encoding). از https:// استفاده کنید؛ برای نشانی http://، Piko به کاربر هشدار می‌دهد که رمزگذاری نشده است.
name: اختیاری. نامی که تا رسیدن سرآیند profile-title شما نشان داده می‌شود.

این‌ها هم پشتیبانی می‌شوند:

piko://add?url=…&name=… و piko://install-config?url=…، همانند بالا؛
piko://add/<url> با نشانی اشتراک به همان شکل (قالب Happ)؛
piko://import?data=… با پیوندهای اشتراک‌گذاری به کدگذاری درصدی یا base64، برای افزودن تک‌سرورها.

پیوند piko:// فقط جایی برنامه را باز می‌کند که Piko نصب باشد، پس نشانی معمولی اشتراک را هم برای کپی‌کردن نشان دهید. وقتی کاربران پیوندهای happ://add/<url> و v2rayng://install-sub?url=… را جای‌گذاری یا اسکن کنند، Piko آن‌ها را هم می‌فهمد.

Piko چه می‌فرستد

Piko اشتراک را با یک درخواست سادهٔ GET و این سرآیندها دریافت می‌کند:

سرآیند	نمونه	معنا
`User-Agent`	`Piko/0.1.0/Android/36`	`Piko/<version>/<os>/<os-version>`: نسخهٔ برنامه، سیستم‌عامل و نسخهٔ آن. پیشوند `Piko/` ثابت است، پس می‌توانید با آن قالب مناسب را برگردانید. Piko هرگز User-Agent مرورگر نمی‌فرستد.
`x-hwid`	۳۲ نویسهٔ شانزده‌شانزدهی	شناسهٔ دستگاهی که فقط برای دامنهٔ شما ساخته شده است. همان دستگاه به ارائه‌دهندگان دیگر مقدار دیگری می‌دهد.
`x-device-os`	`Android`، `iOS`	سیستم‌عامل.
`x-ver-os`	`16`	نسخهٔ سیستم.
`x-device-model`	`Pixel 9`، `iPhone17,3`	مدل دستگاه (هرگز نامی که کاربر روی دستگاه گذاشته نیست).

سرآیندهای دستگاه فقط به میزبان خود اشتراک شما و نشانی‌هایی که در new-url، new-domain یا fallback-url تعیین کرده‌اید فرستاده می‌شوند. هنگام تغییر مسیر به میزبان‌های دیگر حذف می‌شوند. در موارد نادر، مثلاً در iOS پیش از نخستین باز کردن قفل پس از راه‌اندازی دوباره، Piko هیچ‌کدام را نمی‌فرستد.

قالب‌های پشتیبانی‌شده

فهرستی از پیوندهای اشتراک‌گذاری به‌صورت متن ساده یا base64: vless://، vmess://، trojan://، ss:// (از جمله Shadowsocks 2022) و hysteria2:// (hy2://).
یک پیکربندی کامل Xray JSON. Piko شنونده‌های محلی، فایل‌های گزارش و تنظیمات دیگری را که به برنامهٔ گوشی مربوط نیستند حذف می‌کند.
لایه‌های انتقال: TCP (RAW)، WebSocket، gRPC، HTTPUpgrade، XHTTP (SplitHTTP) و mKCP. امنیت: TLS، REALITY و XTLS Vision.
پشتیبانی نمی‌شوند: sing-box JSON، Clash YAML، WireGuard، TUIC، AnyTLS، NaiveProxy، ShadowTLS و دیگر پروتکل‌های خارج از Xray، لایه‌های انتقال حذف‌شدهٔ h2 و QUIC، افزونه‌های ss:// و Hysteria2 با insecure=1. VLESS بدون رمزگذاری به سرور عمومی رد می‌شود.

از سرورهایی استفاده کنید که اتصال را رمزگذاری می‌کنند: TLS، REALITY، Shadowsocks 2022 یا Hysteria2. قوانین فروشگاه‌های برنامه از برنامه‌های VPN می‌خواهند ترافیک را تا سرور رمزگذاری کنند، پس ممکن است Piko سرورهای بدون رمزگذاری را رد کند.

سرآیندهایی که Piko رعایت می‌کند

این‌ها را به‌صورت سرآیند پاسخ بفرستید. همین نام‌ها به شکل سطرهای #key: value در ابتدای بدنهٔ پاسخ (قالب Happ) هم کار می‌کنند. اگر هر دو باشند، سرآیند اولویت دارد.

سرآیند	Piko چه می‌کند
`subscription-userinfo`	`upload=…; download=…; total=…; expire=…` بر حسب بایت و زمان Unix (۰ یعنی نامحدود یا بدون انقضا). Piko ترافیک مصرف‌شده و روزهای باقی‌مانده را نشان می‌دهد و در Android پیش از انقضا یادآوری می‌کند.
`profile-title`	نام اشتراک، به‌صورت متن ساده یا `base64:…`. اگر نباشد، Piko از نام فایل در `content-disposition` استفاده می‌کند.
`profile-update-interval`	فاصلهٔ به‌روزرسانی، بر حسب ساعت. پیش‌فرض ۴ است.
`support-url`	پیوند پشتیبانی (`https://`، `tg:` یا `mailto:`) که زیر «از ارائه‌دهنده» نشان داده می‌شود.
`profile-web-page-url`	سایت یا صفحهٔ حساب کاربری شما.
`support-email`	نشانی ایمیل پشتیبانی.
`announce`	پیامی برای نمایش، به‌صورت متن ساده یا `base64:…`.
`announce-url`	پیوند اطلاعیه‌های شما (`https://` یا `tg:`).
`sub-info-text`، `sub-info-button-text`، `sub-info-button-link`	بنری با دکمهٔ اختیاری (قالب Happ).
`routing`، `routing-enable`	نمایهٔ مسیریابی به‌صورت پیوند مسیریابی (قالب Happ، مثلاً `piko://routing/add/<base64>`). Piko آن را فقط پس از موافقت کاربر اعمال می‌کند. `routing-enable: 0` آن را خاموش می‌کند.
`new-url`، `new-domain`	اشتراک شما جابه‌جا شده است. Piko نشانی جدید را دریافت می‌کند و اگر کار کند، نگهش می‌دارد. فقط نشانی‌های `https://` روی میزبان‌های عمومی پذیرفته می‌شوند.
`fallback-url`	آینه‌ای که Piko وقتی نشانی اصلی کار نمی‌کند از آن استفاده می‌کند، بدون اینکه پیوند کاربر را تغییر دهد.
`check-url-via-proxy`	نشانی `https://` که Piko برای آزمون تأخیر پیکربندی‌های Xray JSON از طریق سرورهای شما درخواست می‌کند.
`x-hwid-active`، `x-hwid-not-supported`، `x-hwid-max-devices-reached`، `x-hwid-limit`	وضعیت محدودیت دستگاه (`true` یا `1`). Piko دلیل رد شدن را برای کاربر توضیح می‌دهد و پیوند پشتیبانی شما را نشان می‌دهد.

ورودی‌هایی در فهرست سرورها که در واقع پیام هستند (مثلاً «سروری» به نام «۵ روز تا انقضا») به‌صورت پیام نشان داده می‌شوند، نه سرور.

پیوندهای محافظت‌شده

Piko می‌تواند پیوندهای piko://crypt1/… را باز کند که نشانی اشتراک را از کپی‌شدن اتفاقی پنهان می‌کنند: Piko نشانی‌ای را که این‌گونه اضافه شده هرگز نشان نمی‌دهد، کپی یا صادر نمی‌کند. این یک مبهم‌سازی است، نه DRM: کلید درون برنامه است. ابزار ساخت این پیوندها همراه با انتشار عمومی Piko در اختیار ارائه‌دهندگان قرار می‌گیرد. برای باخبر شدن به support@pikonet.io بنویسید.

آزمایش و پرسش‌ها

یک اشتراک آزمایشی در Piko اضافه کنید و جزئیات آن را بررسی کنید: نام، ترافیک، تاریخ انقضا و پیام‌های شما. اگر پنل شما با Piko کار نمی‌کند، با ذکر نام و نسخهٔ پنل به support@pikonet.io بنویسید. لطفاً یک اشتراک آزمایشی بفرستید، هرگز اشتراک یک مشتری واقعی را.