راهنمای کامل نصب Papra روی VPS ایران؛ ساخت آرشیو دیجیتال اسناد، فاکتورها و قراردادها

با رشد کسب‌وکارها و افزایش حجم فایل‌های کاری، فاکتورها، قراردادها و اسناد مالی، نگهداری سنتی فایل‌ها روی کامپیوترهای شخصی یا سرویس‌های ابری عمومی دیگر پاسخگو نیست. مشکلاتی مانند پراکندگی فایل‌ها، نگرانی‌های امنیتی، وابستگی به سرویس‌های خارجی و هزینه‌های اشتراک ماهانه، کسب‌وکارها را به سمت راهکارهای اختصاصی سوق می‌دهد.

Papra یک پلتفرم متن‌باز مدیریت و آرشیو اسناد است که به شما اجازه می‌دهد یک مرکز اسناد اختصاصی روی سرور مجازی خود راه‌اندازی کنید. برخلاف سرویس‌های ابری، در نصب شخصی Papra تمام اطلاعات روی سرور شما ذخیره می‌شود و کنترل کامل در اختیار شماست .

Papra چیست و چه کاربردی دارد؟

Papra یک نرم‌افزار سبک و کارآمد برای مدیریت اسناد بلندمدت طراحی شده است. این پلتفرم با تمرکز بر سادگی و کارایی، امکانات زیر را در اختیار شما قرار می‌دهد:

🔹 ذخیره‌سازی سازمان‌یافته اسناد مالی، فاکتورها و قراردادها
🔹 دسته‌بندی و برچسب‌گذاری فایل‌ها برای جستجوی سریع
🔹 مدیریت دسترسی کاربران مختلف در محیط کاری
🔹 یکپارچه‌سازی با ایمیل برای دریافت خودکار اسناد
🔹 رمزنگاری اسناد با استاندارد AES-256-GCM

برخلاف بسیاری از سیستم‌های مدیریت اسناد که پیچیدگی زیادی دارند، Papra با رابط کاربری مینیمال، مدیریت آرشیو را برای هر کسب‌وکاری ساده می‌کند .

چرا Papra را روی VPS ایران نصب کنیم؟

راه‌اندازی Papra روی سرور مجازی ایران برای شرکت‌ها، فروشگاه‌ها و کسب‌وکارهای داخلی مزایای قابل توجهی دارد:

سرعت دسترسی بهتر برای کاربران داخلی

اگر تیم شما داخل ایران فعالیت می‌کند، قرار گرفتن سرور در دیتاسنتر داخلی تأخیر شبکه را به حداقل می‌رساند و بارگذاری فایل‌ها سرعت بیشتری خواهد داشت. این موضوع در مدیریت روزانه اسناد حجیم مانند فایل‌های PDF اسکن‌شده اهمیت زیادی دارد.

کنترل کامل بر داده‌ها

در سرویس‌های ابری، اطلاعات شما روی زیرساخت شرکت دیگری قرار می‌گیرد. اما در VPS اختصاصی شما مالک اطلاعات هستید، سیاست‌های امنیتی خود را اجرا می‌کنید و هیچ وابستگی به سرویس‌های خارجی ندارید.

کاهش هزینه‌های بلندمدت

اشتراک ماهانه سرویس‌های ذخیره‌سازی ابری در بلندمدت هزینه‌بر است. با یک سرور مجازی می‌توانید منابع را متناسب با نیاز خود تنظیم کنید و بدون پرداخت هزینه‌های اضافی، فضای ذخیره‌سازی خود را مدیریت کنید.

مشخصات پیشنهادی سرور برای اجرای Papra

Papra به دلیل معماری سبک خود، منابع زیادی مصرف نمی‌کند. اما برای عملکرد روان در محیط کاری با چند کاربر، مشخصات زیر پیشنهاد می‌شود:

اگر قصد آرشیو حجم زیادی از فاکتورهای اسکن‌شده را دارید، فضای دیسک NVMe انتخاب بهتری است، زیرا سرعت خواندن و نوشتن فایل‌های حجیم در آن بالاتر است .

مراحل نصب Papra روی VPS

در این بخش، نصب Papra را به صورت گام‌به‌گام روی سرور مجازی لینوکس بررسی می‌کنیم.

اتصال به سرور

با استفاده از ترمینال یا نرم‌افزاری مانند PuTTY به سرور متصل شوید:

ssh root@SERVER_IP

به جای SERVER_IP، آدرس آی‌پی سرور خود را قرار دهید.

به‌روزرسانی سرور

پیش از نصب، سیستم را آپدیت کنید:

apt update && apt upgrade -y

نصب Docker و Docker Compose

Papra به صورت پیشنهادی با Docker اجرا می‌شود . برای نصب Docker و Docker Compose:

apt install docker.io docker-compose -y

سپس سرویس Docker را فعال کنید:

systemctl start docker
systemctl enable docker

بررسی صحت نصب:

docker --version

ساخت فایل Docker Compose برای Papra

ابتدا پوشه اختصاصی Papra را ایجاد کنید:

mkdir -p /opt/papra/app-data/{db,documents}
cd /opt/papra

سپس فایل docker-compose.yml را بسازید:

nano docker-compose.yml

محتوای زیر را در فایل قرار دهید:

services:
  papra:
    image: ghcr.io/papra-hq/papra:latest
    container_name: papra
    restart: unless-stopped
    ports:
      - "1221:1221"
    environment:
      - APP_BASE_URL=http://SERVER_IP:1221
      - AUTH_SECRET=YOUR_SECRET_KEY
    volumes:
      - ./app-data:/app/app-data
    user: "${UID}:${GID}"

⚠️ نکات مهم:

🔹 به جای YOUR_SECRET_KEY یک کلید امنیتی تصادفی قرار دهید. برای تولید آن می‌توانید از دستور openssl rand -hex 48 استفاده کنید .
🔹 به جای SERVER_IP آی‌پی واقعی سرور خود را وارد کنید.
🔹 وجود بخش volumes برای حفظ اطلاعات پس از ری‌استارت ضروری است .

ذخیره فایل:

CTRL + X
Y
ENTER

اجرای Papra

حالا سرویس را اجرا کنید:

UID=$(id -u) GID=$(id -g) docker compose up -d

بررسی وضعیت کانتینر:

docker ps

اگر کانتینر Papra در حال اجرا باشد، به پنل مدیریت دسترسی خواهید داشت.

ورود به پنل Papra و ایجاد حساب کاربری

در مرورگر خود آدرس زیر را وارد کنید:

http://SERVER_IP:1221

صفحه مدیریت Papra نمایش داده می‌شود. اولین کاربری که ثبت‌نام کند، به صورت خودکار دسترسی ادمین دریافت می‌کند .

اتصال دامنه به Papra و فعال‌سازی HTTPS

برای استفاده حرفه‌ای و امن، بهتر است به جای آی‌پی از دامنه اختصاصی استفاده کنید. یک رکورد A در DNS خود ایجاد کنید:

archive.example.com → SERVER_IP

سپس با Nginx یا Caddy می‌توانید SSL رایگان فعال کنید. برای نصب Nginx:

apt install nginx -y

یک فایل کانفیگ برای Papra بسازید:

nano /etc/nginx/sites-available/papra

محتوا:

server {
    listen 80;
    server_name archive.example.com;

    location / {
        proxy_pass http://127.0.0.1:1221;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

فعال‌سازی سایت و ری‌استارت Nginx:

ln -s /etc/nginx/sites-available/papra /etc/nginx/sites-enabled/
systemctl restart nginx

برای دریافت SSL رایگان:

apt install certbot python3-certbot-nginx -y
certbot --nginx

پس از انجام مراحل، سایت شما با HTTPS باز می‌شود:

https://archive.example.com

افزایش امنیت Papra روی VPS

برای محافظت از آرشیو اسناد، اقدامات امنیتی زیر را انجام دهید:

فعال‌سازی فایروال UFW

apt install ufw
ufw allow ssh
ufw allow 80
ufw allow 443
ufw enable

نصب Fail2Ban برای جلوگیری از حملات ورود

apt install fail2ban -y

⚠️ توصیه امنیتی: پورت پیش‌فرض SSH را تغییر دهید و احراز هویت با کلید SSH را فعال کنید.

بکاپ‌گیری از آرشیو Papra

اطلاعات مهم‌ترین بخش یک سیستم آرشیو اسناد است. برای بکاپ‌گیری از داده‌های Papra:

tar -czvf papra-backup-$(date +%Y%m%d).tar.gz /opt/papra/app-data

بکاپ‌ها را روی سرور دیگر، هارد جداگانه یا فضای ذخیره‌سازی خارجی نگهداری کنید. برای اطلاعات حساس، حتی می‌توانید بکاپ‌ها را رمزنگاری کنید.

مشکلات رایج و راه‌حل آن‌ها

مشکل ۱: پنل Papra باز نمی‌شود

بررسی کنید کانتینر فعال باشد:

docker ps

اگر کانتینر خاموش بود:

docker compose restart

مشکل ۲: پورت 1221 در دسترس نیست

بررسی کنید پورت باز باشد:

ss -tulpn | grep 1221

وضعیت فایروال را بررسی کنید:

ufw status

مشکل ۳: اطلاعات بعد از ری‌استارت از بین می‌رود

اگر volume در فایل Docker Compose تعریف نشده باشد، اطلاعات داخل کانتینر ذخیره می‌شوند و با حذف کانتینر از بین می‌روند. وجود این بخش ضروری است:

volumes:
  - ./app-data:/app/app-data

کاربردهای Papra برای کسب‌وکارها

آرشیو فاکتورهای فروش

فروشگاه‌ها می‌توانند فاکتور مشتریان، مدارک پرداخت و رسیدهای بانکی را به صورت سازمان‌یافته ذخیره کنند و بر اساس تاریخ یا مشتری جستجو کنند.

مدیریت قراردادها

شرکت‌ها می‌توانند قراردادهای مشتریان، قراردادهای همکاری و فایل‌های حقوقی را در یک محیط امن و با کنترل دسترسی نگهداری کنند.

ذخیره اسناد حسابداری

تیم‌های مالی می‌توانند گزارش‌های مالی، فایل‌های حسابداری، رسیدها و اسناد بانکی را در Papra مدیریت کنند.

این آموزش برای چه سرورهایی مناسب است؟

این راهنما روی اکثر توزیع‌های لینوکس قابل اجرا است:

🔹 Ubuntu 20.04 / 22.04 / 24.04
🔹 Debian 11 / 12 / 13
🔹 Rocky Linux
🔹 AlmaLinux
🔹 CentOS
🔹 Fedora Server
🔹 Oracle Linux

نام بعضی دستورات مدیریت سرویس، فایروال و نصب پکیج‌ها ممکن است در هر توزیع متفاوت باشد.

سوالات متداول درباره نصب Papra

آیا Papra روی سرور مجازی با ۱ گیگابایت رم هم اجرا می‌شود؟

بله، Papra سبک است و با ۱ گیگابایت رم نیز اجرا می‌شود، اما برای محیط کاری با چند کاربر، ۲ گیگابایت رم توصیه می‌شود.

آیا می‌توانم اسناد را در Papra رمزنگاری کنم؟

بله، Papra از رمزنگاری AES-256-GCM پشتیبانی می‌کند. با تنظیم متغیرهای محیطی مناسب می‌توانید رمزنگاری را فعال کنید .

آیا Papra از دریافت اسناد از طریق ایمیل پشتیبانی می‌کند؟

بله، با استفاده از Cloudflare Email Workers یا سرویس OwlRelay می‌توانید اسناد را مستقیماً به Papra ارسال کنید .

آیا اطلاعات Papra بعد از آپدیت از بین می‌رود؟

خیر، اگر volume در Docker Compose تعریف شده باشد، اطلاعات در پوشه app-data ذخیره می‌شود و آپدیت‌ها آن را حذف نمی‌کنند.

آیا Papra برای سازمان‌های کوچک و متوسط مناسب است؟

بله، Papra برای کسب‌وکارهای کوچک و متوسط طراحی شده و با مدیریت دسترسی کاربران، برای تیم‌های کاری مناسب است.