OpenCode روی سرور ابری: نصب، اجرا با serve، اتصال
از 2026-10-20 میتوانید OpenCode را روی یک سرور ابری QCode نصب کنید، آن را با opencode serve در حال اجرا نگه دارید و مدل‌ها را با کلید QCode خود فراخوانی کنید. سرورهای ابری و سرویسهای هوش مصنوعی جداگانه فروخته میشوند؛ آنها فقط حساب کاربری و موجودی را مشترک دارند.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورتحساب بهازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته استقرار
سرور HTTP بدون رابط گرافیکی
مستندات رسمی سرور: opencode serve یک سرور HTTP بدون رابط گرافیکی اجرا میکند که یک نقطه پایانی OpenAPI را ارائه می‌دهد؛ پورت پیشفرض 4096 و نام میزبان پیشفرض 127.0.0.1 است.
دسترسی کامل root
سرور ابری QCode یک میزبان KVM با یک IPv4 عمومی اختصاصی و دسترسی کامل root است؛ مدیریت سیستم و داده‌ها بر عهده شماست.
مدت دوره آزمایشی
دوره آزمایشی 1 روز (24 ساعت) است و بر اساس اندازه‌ای که انتخاب میکنید هزینه دریافت میشود؛ در طول دوره آزمایشی میتوانید آن را از پنل برای 1، 3، 6 یا 12 ماه نگه دارید، در غیر این صورت سرور در پایان حذف میشود و داده‌ها نگه داشته نمی‌شوند.
اختیاری هنگام سفارش
هنگام سفارش میتوانید یک کلید عمومی SSH اضافه کنید و گزینه «فقط ورود با کلید (غیرفعال کردن ورود با رمز root)» را تیک بزنید. هنوز کنسول وب وجود ندارد: اگر کلید خصوصی را از دست بدهید، تنها راه بازگشت، نصب مجدد سیستم است که داده‌های آن را پاک میکند.
چه چیزهایی میتوانید روی سرور اجرا کنید
برای اجرای OpenCode روی یک سرور ابری QCode، یک میزبان KVM با دسترسی root سفارش دهید، OpenCode را با اسکریپت رسمی نصب کنید، نقاط پایانی QCode را در opencode.json قرار دهید و opencode serve را داخل tmux اجرا کنید. سرور ابری QCode ماشینی خارج از کشور است که بهصورت مستقل فروخته میشود و یک IPv4 عمومی اختصاصی دارد؛ محصولی جدا از سرویس هوش مصنوعی است و این دو فقط حساب کاربری و موجودی را مشترک دارند. مستندات QCode کشورها و مناطق هنگ‌کنگ، ژاپن، کره، ایالات متحده و آلمان را فهرست میکند و برای هر منطقه یک یا چند خط دارد.
صفحات رسمی چه می‌گویند
مستندات رسمی سرور OpenCode (opencode.ai/docs/server، بخشی از مستندات OpenCode 1) می‌گوید opencode serve یک سرور HTTP بدون رابط گرافیکی است؛ پورت پیشفرض 4096 و نام میزبان پیشفرض 127.0.0.1 است و میتوانید آنها را با --hostname و --port تغییر دهید. تنظیم OPENCODE_SERVER_PASSWORD احراز هویت پایه HTTP را فعال میکند؛ نام کاربری به‌طور پیشفرض opencode است. صفحه OpenCode در مستندات QCode نقاط پایانی QCode را در ~/.config/opencode/opencode.json نشان می‌دهد.
گاه‌شمار
صفحه OpenCode در مستندات QCode در 2026-10-20 بررسی شد و اکنون بخش OpenCode 2 را دارد.
بسته npm با نام @opencode/cli برای OpenCode 2 نسخه 2.1.0 را منتشر کرد. opencode.ai/docs همچنان مستندات OpenCode 1 است؛ مستندات OpenCode 2 در opencode.ai/v2/docs قرار دارد.
مستندات سرور ابری QCode و صفحه Cloud در 2026-10-20 بررسی شدند: میتوانید اندازه را بهصورت آنلاین ارتقا دهید، هر سرور حداکثر 3 اسنپ‌شات دارد و صفحه سفارش کلیدهای عمومی SSH اختیاری را می‌پذیرد.
تأییدشده در مقابل تأییدنشده
تأییدشده (عیناً در صفحات رسمی)
سرورهای ابری QCode: ماشینی در خارج از کشور که بهصورت جداگانه فروخته میشود، KVM، دسترسی کامل root، 1 IPv4 عمومی اختصاصی برای هر سرور (هنگام آماده شدن تخصیص مییابد و قابل تغییر نیست)، هنگ‌کنگ، ژاپن، کره، ایالات متحده و آلمان، دوره آزمایشی پرداختی 1 روزه (24 ساعت)، امکان تبدیل به 1، 3، 6 یا 12 ماه در طول دوره آزمایشی، ارتقاهای آنلاین اندازه، و حداکثر 3 اسنپ‌شات برای هر سرور. OpenCode: opencode serve یک سرور HTTP بدون رابط گرافیکی است، به‌طور پیشفرض 127.0.0.1:4096، و OPENCODE_SERVER_PASSWORD احراز هویت پایه را فعال میکند؛ اسکریپت نصب رسمی OpenCode 1 بهصورت curl -fsSL https://opencode.ai/install. است.
تأییدنشده و منتشرنشده توسط ارائه‌دهنده
یک کاربر GitHub گزارش می‌دهد (#56668، ثبت‌شده در 2026-10-18 برای Desktop 2.0.32 و همچنان باز در 2026-10-20) که در نسخه دسکتاپ، نخستین اتصال SSH به یک سرور راه دور جدید می‌تواند چند دقیقه صرف دانلود یا آپلود سرور OpenCode راه دور کند، در حالی که پنجره گفت‌وگو فقط «Connecting over SSH…» را نشان می‌دهد و به همین دلیل یخ‌زده به نظر می‌رسد. این یک گزارش کاربر است، نه یک نتیجه‌گیری رسمی.
دو روش اجرا
دستور opencode serve
یک سرویس HTTP بدون رابط گرافیکی برای سایر کلاینت‌ها یا اسکریپت‌ها. به‌طور پیشفرض فقط به 127.0.0.1 گوش می‌دهد؛ برای دسترسی از راه دور، آدرس را با --hostname تغییر دهید و آن را با OPENCODE_SERVER_PASSWORD محافظت کنید.
TUI محلی
مستندات رسمی سرور می‌گوید اجرای opencode هم یک TUI و هم یک سرور را راهاندازی میکند، که TUI همان کلاینتی است که با سرور گفتگو میکند؛ opencode serve یک سرور مستقل راهاندازی میکند.
مراحل استقرار
① یک سرور ابری QCode سفارش دهید: منطقه، خط، اندازه، سیستم‌عامل و مدت را انتخاب کنید؛ برای دوره آزمایشی، 1 روز را انتخاب کنید. مرحله شبکه همیشه شامل 1 IPv4 عمومی اختصاصی است؛ مرحله رمز root یک فیلد اختیاری برای کلید عمومی SSH دارد. ② پس از تحویل، با ssh root@SERVER_IP وارد شوید؛ رمز root همان رمزی است که هنگام سفارش تعیین کردید. ③ OpenCode را با صفحه نصب رسمی نصب کنید: curl -fsSL https://opencode.ai/install | bash. صفحه رسمی این اسکریپت را به‌عنوان روش نصب OpenCode 1 معرفی میکند؛ مستندات QCode می‌گوید پیکربندی provider / options.baseURL در صفحه OpenCode آن هم در OpenCode 1 و هم در OpenCode 2 کار میکند. OpenCode 2 فرمان نصب متفاوتی دارد و این دو را نمیتوان با فرمان پیشفرض در کنار هم نصب کرد (پرسش متداول آخر را ببینید). ④ نقاط پایانی QCode را در ~/.config/opencode/opencode.json بنویسید و کلید را با opencode auth login ذخیره کنید. ⑤ آن را در tmux در حال اجرا نگه دارید: tmux new -s opencode، سپس OPENCODE_SERVER_PASSWORD=your-password opencode serve را اجرا کنید (به‌طور پیشفرض فقط به 127.0.0.1:4096 گوش می‌دهد)، Ctrl+B و سپس D را فشار دهید تا جدا شوید، و با tmux attach -t opencode بازگردید.
اتصال OpenCode به QCode
راهاندازی مستندشده OpenCode در QCode: فایل پیکربندی ~/.config/opencode/opencode.json است؛ baseURL ارائه‌دهنده Anthropic را روی https://api.qcode.cc/claude/v1 و ارائه‌دهنده OpenAI را روی https://api.qcode.cc/openai/v1 تنظیم کنید. کلید را با opencode auth login یا /connect بنویسید؛ OpenCode 1 آن را در ~/.local/share/opencode/auth.json ذخیره میکند و OpenCode 2 از SQLite استفاده میکند و auth.json قدیمی را وارد میکند. ابتدا دسترسی مستقیم API را فعال کنید: به‌طور پیشفرض غیرفعال است و باید با پشتیبانی آنلاین تماس بگیرید یا به hi@qcode.cc ایمیل بزنید تا آن را برای کلید API خریداری‌شده شما فعال کنند. صورتحساب بر اساس توکن است و نرخ هر مدل در /models آمده است. برای پلن ماهانه آماده نیستید؟ بسته‌های پرداخت بهازای مصرف از $4 شروع میشوند برای سهمیه یک‌باره‌ای که ظرف 7 روز مصرف میکنید. اگر از قبل پلن‌های شخصی دارید، هر زمان به سهمیه بیشتری نیاز داشتید یک بسته تقویتی اضافه کنید.
پرسش‌های متداول
چگونه OpenCode را روی سرور ابری نصب کنم؟
از اسکریپت صفحه نصب رسمی OpenCode استفاده کنید: curl -fsSL https://opencode.ai/install | bash. صفحه رسمی آن را به‌عنوان روش نصب OpenCode 1 معرفی میکند. OpenCode 2 از فرمان نصب متفاوتی استفاده میکند؛ پرسش آخر را در پایین ببینید.
آیا با قطع شدن SSH، opencode serve متوقف میشود؟
اگر آن را در پیشزمینه اجرا کنید، با قطع اتصال پایان مییابد. مستندات QCode نگه داشتن کارها در tmux را توصیف میکند (نام نشست در مثال آنها agent است؛ هر نامی کار میکند و اینجا از opencode استفاده شده است): tmux new -s opencode یک نشست میسازد، opencode serve را اجرا کنید، Ctrl+B و سپس D را فشار دهید تا جدا شوید، و با tmux attach -t opencode بازگردید. نشستهای tmux از قطع اتصال ناخواسته یا جدا شدن جان سالم به در میبرند.
چگونه OpenCode را وادار کنم مدل‌ها را با کلید QCode فراخوانی کند؟
مستندات QCode را دنبال کنید: ~/.config/opencode/opencode.json را با https://api.qcode.cc/claude/v1 به‌عنوان baseURL ارائه‌دهنده Anthropic و https://api.qcode.cc/openai/v1 به‌عنوان baseURL ارائه‌دهنده OpenAI بنویسید. کلید را با opencode auth login یا /connect بنویسید؛ OpenCode 1 آن را در ~/.local/share/opencode/auth.json ذخیره میکند و OpenCode 2 از SQLite استفاده میکند و auth.json قدیمی را وارد میکند. ابتدا دسترسی مستقیم API را فعال کنید.
آیا باید همراه با سرور ابری، یک پلن هوش مصنوعی هم بخرم؟
خیر. در مستندات QCode آمده است که سرورهای ابری و سرویسهای هوش مصنوعی جداگانه فروخته میشوند و فقط حساب کاربری و موجودی را مشترک دارند، و اجرای Claude Code یا Codex روی سرور به این معنا نیست که باید پلن هوش مصنوعی بخرید. برای اینکه OpenCode مدلهای QCode را فراخوانی کند، از کلید QCode خود استفاده میکنید؛ سمت مدل بهازای هر توکن صورتحساب میشود و نرخ هر مدل در /models آمده است.
آیا میتوانم سرور ابری را ارتقا دهم یا خط آن را تغییر دهم؟
میتوانید اندازه را بهصورت آنلاین ارتقا دهید: در تب Actions سرور، پلن بزرگتری انتخاب کنید و مابهالتفاوت تا تاریخ انقضا را بپردازید؛ بلافاصله اعمال میشود، سرور یک بار راهاندازی مجدد میشود و تاریخ انقضا ثابت میماند. کاهش پلن و جابهجایی به منطقه یا خط دیگر در دسترس نیست؛ برای خط متفاوت، سرور دیگری سفارش دهید. ابتدا باید نسخه آزمایشی به پلن ماهانه تبدیل شود.
آیا باید OpenCode 1 یا OpenCode 2 را روی سرور نصب کنم؟
به این بستگی دارد که کدام مستندات را دنبال میکنید. opencode.ai/docs، از جمله صفحه سرور آن، مستندات OpenCode 1 است و curl -fsSL https://opencode.ai/install، OpenCode 1 را نصب میکند. مستندات OpenCode 2 در opencode.ai/v2/docs قرار دارد و اسکریپت نصب آن curl -fsSL https://opencode.ai/v2/install | bash است. هر دو از فرمان opencode استفاده میکنند و نمیتوان آنها را در کنار هم با فرمان پیشفرض نصب کرد؛ نصبکننده curl مربوط به OpenCode 2 باینری V1 را جایگزین میکند. نمونه opencode.json برای QCode در صفحه OpenCode در QCode قرار دارد (بررسیشده در 2026-10-20)؛ بر اساس مستندات QCode، پیکربندی provider / options.baseURL آن در هر دو OpenCode 1 و OpenCode 2 کار میکند.
منابع
مستندات سرور ابری QCode (ثبت‌شده در 2026-10-20؛ مناطق، نسخه آزمایشی، ارتقاها، اسنپ‌شات‌ها، کلیدهای SSH)؛ صفحه QCode Cloud (ثبت‌شده در 2026-10-20)؛ مستندات صورتحساب ابری QCode (ثبت‌شده در 2026-10-20)؛ مستندات عامل‌های سرور ابری QCode (ثبت‌شده در 2026-10-20؛ tmux و زبان‌های رابط)؛ مستندات رسمی سرور و نصب OpenCode (ثبت‌شده در 2026-10-20)؛ صفحه OpenCode در QCode و صفحه پرداخت بهازای مصرف (ثبت‌شده در 2026-10-20).
OpenCode را روی یک ماشین همیشه‌روشن قرار دهید
قیمت‌های شروع و خطوط سرور ابری در qcode.cc/en/cloud آمده است؛ رابط سرور ابری در حال حاضر فقط به زبان‌های چینی و انگلیسی در دسترس است.
مطالب مرتبط
بسته‌های پرداخت بهازای مصرف Claude Code: بدون اشتراک، 7 روز
سهمیه را یک‌بار بخرید و ظرف 7 روز از آن استفاده کنید، بدون اشتراک؛ بسته‌های اضافی به همان کلید اضافه میشوند.
حذف اشتراک‌گذاری نشست OpenCode (1.19.1) و ارتقا به نسخه 2
چه چیزی در اشتراک‌گذاری نشست و انتقال به OpenCode 2 تغییر کرده است.
OpenCode 2026: 200K+ ستاره، عامل کدنویسی متن‌باز با هوش مصنوعی
OpenCode چیست، نحوه نصب آن، استفاده چندعاملی و BYOK، و راهاندازی روی QCode.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
جزئیات سرور ابری در این صفحه در 2026-10-20 با qcode.cc/cloud و docs.qcode.cc بررسی شده است؛ جزئیات OpenCode در 2026-10-20 با صفحه نصب رسمی و مستندات سرور بررسی شده است؛ دسترس‌پذیری و نرخ مدل‌ها تابع /models است. تغییرات رسمی جداگانه اعلام نمی‌شوند.