NX Shop

از NX · shop

رسمی

فروش پلن‌های پنل: ربات تلگرام، وب‌اپ و مینی‌اپ؛ رسید کارت‌به‌کارت، پیامک بانک و درگاه‌های خودتان؛ کیف پول، تمدید، کد تخفیف و هدیه، دعوت و نماینده؛ گزارش‌ها و پشتیبان رمزشده — به فارسی، انگلیسی، روسی و چینی.

نصب

دستی

روی سروری که افزونه قرار است رویش باشد، با کاربر root اجرا کنید:

به‌صورت سرویس (بدون Docker)

curl -fsSL https://raw.githubusercontent.com/nx-panel/shop/v0.1.1/install.sh -o install.sh
sh install.sh --method script --version v0.1.1 \
  --opt port=8095 \
  --opt database=sqlite \
  --opt admin_username=admin \
  --opt admin_password=<admin_password> \
  --opt https=panel \
  --panel-url https://<your-panel>

با Docker

curl -fsSL https://raw.githubusercontent.com/nx-panel/shop/v0.1.1/install.sh -o install.sh
sh install.sh --method docker --version v0.1.1 \
  --opt port=8095 \
  --opt database=sqlite \
  --opt admin_username=admin \
  --opt admin_password=<admin_password> \
  --opt https=panel \
  --panel-url https://<your-panel>

بعد در پنل به افزونه‌ها ← ثبت افزونهٔ امضاشده بروید و آدرس افزونه و کد ادعایی را که نشان می‌دهد وارد کنید.

گزینه‌های نصب

گزینه	نوع	پیش‌فرض
پورت Shop روی این پورت گوش می‌دهد. با HTTPS روشن فقط همین پورت HTTPS می‌دهد و آدرس عمومی همین پورت را دارد (برای acme ۴۴۳). `NX_OPT_PORT`	`port`	`8095`
مسیر ادمین ادمین فروشگاه و درخواست‌های پنل زیر این مسیرند؛ صفحه‌های مشتری در ریشه می‌مانند و آن را نشان نمی‌دهند. خالی: ریشه. `NX_OPT_BASE_PATH`	`path`	`—`
دیتابیس SQLite همه‌چیز را در پوشهٔ دادهٔ فروشگاه نگه می‌دارد. PostgreSQL سروری است که خودتان دارید. `NX_OPT_DATABASE`	`choice: sqlite \| postgres`	`sqlite`
اتصال PostgreSQL host=… user=… password=… dbname=… sslmode=… `NX_OPT_DATABASE_DSN`	`secret`	`—`	الزامی · فقط وقتی database = postgres
نام کاربری ادمین فروشگاه `NX_OPT_ADMIN_USERNAME`	`string`	`admin`
رمز ادمین فروشگاه دست‌کم ۱۰ نویسه. اولین ادمین را می‌سازد، و نصب دوباره روی داده‌ی مانده هم آن را می‌گذارد؛ بعد در خود فروشگاه عوضش کنید. `NX_OPT_ADMIN_PASSWORD`	`password`	`—`	الزامی
آدرس عمومی فروشگاه آدرسی که مشتری‌ها فروشگاه را با آن باز می‌کنند، مثلاً https://shop.example.com:8095. با HTTPS روشن لازم است و پورت فروشگاه را دارد (بدون پورت ۴۴۳). مینی‌اپ تلگرام https می‌خواهد. `NX_OPT_PUBLIC_URL`	`url`	`—`
گواهی HTTPS panel: گواهی پنل، روی هر پورت. acme: گواهی رایگان، پورت ۴۴۳. acme-http: همان روی هر پورت، بررسی روی ۸۰. self-signed: گواهی خودش، پنل برای اعتماد نشانش می‌دهد. off: HTTP ساده، پشت پراکسی. `NX_OPT_HTTPS`	`choice: panel \| acme \| acme-http \| self-signed \| off`	`panel`
توکن ربات تلگرام از ‎@BotFather. اختیاری است و بعداً در فروشگاه هم می‌شود تنظیمش کرد. یک ربات جدا بسازید، نه ربات پنل. `NX_OPT_BOT_TOKEN`	`secret`	`—`

آنچه از پنل شما می‌خواهد

دسترسی	دلیل
`users:read`	to read back the accounts it sold, and their usage
`users:write`	to create the accounts customers buy, and renew or top them up
`backup:deliver`	to send Shop's own encrypted backup to the backup chat you chose on the panel

رویدادهایی که می‌شنود

panel.addon_removeduser.deleteduser.bulkuser.expiringuser.expireduser.quota_warninguser.quota_reacheduser.renewedpanel.restore_applied