168 lines
5.1 KiB
Markdown
168 lines
5.1 KiB
Markdown
# استقرار کاتالوگ — `ktg.montzar.ir`
|
||
|
||
هاست مشترک مونتایم: `185.50.38.53` (SSH پورت `3031`، کاربر `montime`)
|
||
دامنه: `https://ktg.montzar.ir`
|
||
پورت داخلی: `3020` (۳۰۰۰ مونتایم، ۳۰۰۱ فوری‌سند، ۳۰۱۰ سوپرادمین)
|
||
|
||
دیتابیس Postgres بقیه پروژه‌ها را لمس نکنید. این اپ SQLite خودش را در `/var/www/ktg/data` دارد.
|
||
|
||
---
|
||
|
||
## کارهایی که روی لپ‌تاپ شماست
|
||
|
||
### ۱) بستهٔ ارسال را بسازید
|
||
|
||
در PowerShell:
|
||
|
||
```powershell
|
||
cd E:\projeha\DigitalCatalog
|
||
if (Test-Path catalog-deploy.tar) { Remove-Item catalog-deploy.tar }
|
||
tar --exclude=node_modules --exclude=dist --exclude=storage --exclude=data --exclude=.env --exclude=catalog-deploy.tar -cvf catalog-deploy.tar .
|
||
```
|
||
|
||
### ۲) آپلود روی سرور
|
||
|
||
رمز SSH همانی است که برای سوپرادمین/مونتایم می‌زنید:
|
||
|
||
```powershell
|
||
scp -P 3031 catalog-deploy.tar montime@185.50.38.53:/tmp/catalog-deploy.tar
|
||
```
|
||
|
||
بعد از آپلود، فایل `catalog-deploy.tar` روی ویندوز را می‌توانید پاک کنید.
|
||
|
||
---
|
||
|
||
## کارهایی که روی سرور است
|
||
|
||
SSH:
|
||
|
||
```bash
|
||
ssh -p 3031 montime@185.50.38.53
|
||
```
|
||
|
||
### ۳) پوشه و باز کردن فایل‌ها
|
||
|
||
```bash
|
||
sudo mkdir -p /var/www/ktg
|
||
sudo chown montime:montime /var/www/ktg
|
||
cd /var/www/ktg
|
||
tar -xvf /tmp/catalog-deploy.tar
|
||
rm /tmp/catalog-deploy.tar
|
||
```
|
||
|
||
اگر پوشه از قبل چیزی داشت و آپدیت است، `storage` و `data` را پاک نکنید.
|
||
|
||
### ۴) پورت آزاد باشد
|
||
|
||
```bash
|
||
pm2 list
|
||
ss -tlnp | grep -E '3000|3001|3010|3020' || netstat -tlnp | grep -E '3000|3001|3010|3020'
|
||
```
|
||
|
||
۳۰۲۰ باید خالی باشد. اگر اشغال بود بگویید تا پورت عوض شود؛ خودتان پورت بقیه را عوض نکنید.
|
||
|
||
### ۵) فایل `.env` سرور
|
||
|
||
```bash
|
||
cd /var/www/ktg
|
||
cp deploy/.env.production.example .env
|
||
nano .env
|
||
```
|
||
|
||
باید دقیقاً این باشد (مگر پورت عوض شده باشد):
|
||
|
||
```env
|
||
NODE_ENV=production
|
||
PORT=3020
|
||
API_PORT=3020
|
||
PUBLIC_BASE_URL=https://ktg.montzar.ir
|
||
STORAGE_DIR=/var/www/ktg/storage
|
||
DATABASE_PATH=/var/www/ktg/data/catalogs.sqlite
|
||
```
|
||
|
||
دیتابیس Postgres و `DATABASE_URL` سوپرادمین را اینجا نگذارید.
|
||
|
||
### ۶) نصب، بیلد، پوشه‌ها
|
||
|
||
Node ۲۰ یا جدیدتر.
|
||
|
||
```bash
|
||
cd /var/www/ktg
|
||
npm ci
|
||
npm run build
|
||
mkdir -p storage data
|
||
```
|
||
|
||
### ۷) PM2 — فقط این پروسهٔ جدید
|
||
|
||
پروسه‌های `montime` / `superadmin-api` / فوری‌سند را stop نکنید.
|
||
|
||
```bash
|
||
pm2 start /var/www/ktg/deploy/ecosystem.config.cjs
|
||
pm2 save
|
||
pm2 list
|
||
curl -sI http://127.0.0.1:3020
|
||
```
|
||
|
||
باید `HTTP/1.1 200` بیاید. اگر خطا بود: `pm2 logs ktg-catalog --lines 80`
|
||
|
||
### ۸) Nginx — فقط سایت جدید
|
||
|
||
```bash
|
||
sudo cp /var/www/ktg/deploy/nginx-ktg.montzar.ir.conf /etc/nginx/sites-available/ktg.montzar.ir
|
||
sudo ln -sf /etc/nginx/sites-available/ktg.montzar.ir /etc/nginx/sites-enabled/
|
||
sudo nginx -t && sudo systemctl reload nginx
|
||
```
|
||
|
||
اگر `nginx -t` خطا داد، فایل‌های `adm.montzar.ir` را ویرایش نکنید؛ بگویید خروجی را بفرستید.
|
||
|
||
### ۹) گواهی SSL
|
||
|
||
DNS این زیردامنه از قبل مثل `adm.montzar.ir` روی همان IP است. اگر مرورگر هنوز به سرور نرسید، در پنل دامنه تأیید کنید `ktg.montzar.ir` رکورد `A` مثل `adm.montzar.ir` دارد.
|
||
|
||
```bash
|
||
sudo certbot --nginx -d ktg.montzar.ir
|
||
```
|
||
|
||
Certbot خودش HTTPS را به همین vhost اضافه می‌کند، نه به سایت‌های دیگر.
|
||
|
||
### ۱۰) تست نهایی
|
||
|
||
1. `https://ktg.montzar.ir` صفحهٔ ساخت فارسی
|
||
2. یک PDF/تصویر کوچک بسازید
|
||
3. QR و لینک باید با `https://ktg.montzar.ir/c/...` باشد نه localhost
|
||
4. لینک مشاهده در تب دیگر باز شود
|
||
|
||
کاتالوگ‌های لوکال (`127.0.0.1:3000`) روی این دامنه کار نمی‌کنند؛ باید روی سرور دوباره ساخته شوند.
|
||
|
||
---
|
||
|
||
## آپدیت بعدی کد
|
||
|
||
روی ویندوز دوباره مرحلهٔ ۱ و ۲. روی سرور:
|
||
|
||
```bash
|
||
cd /var/www/ktg
|
||
# اگر tar روی فایل‌های قبلی unpacked می‌شود:
|
||
tar -xvf /tmp/catalog-deploy.tar
|
||
npm ci
|
||
npm run build
|
||
pm2 restart ktg-catalog
|
||
```
|
||
|
||
پوشه‌های `storage` و `data` و فایل `.env` را پاک نکنید.
|
||
|
||
---
|
||
|
||
## تداخل نداشتن (یادآوری)
|
||
|
||
| این پروژه | بقیه — دست نزنید |
|
||
|---|---|
|
||
| دامنه `ktg.montzar.ir` | `adm.montzar.ir` و دامنهٔ مونتایم |
|
||
| پورت ۳۰۲۰ | ۳۰۰۰ / ۳۰۰۱ / ۳۰۱۰ |
|
||
| PM2 نام `ktg-catalog` | پروسه‌های موجود |
|
||
| `/var/www/ktg` | `/var/www/superadmin` و پوشهٔ مونتایم |
|
||
| SQLite داخل `data/` | Postgres |
|
||
|
||
لاگین و پروفایل اگر بعداً آمد، باز هم داخل همین دامنه و همین پوشه است؛ به دیتابیس Nest وصل نمی‌شود.
|