📌 خروجی نهایی این آموزش:

🔹 لینک دانلود تصادفی و غیرقابل حدس

🔹 Token با 256 بیت تصادفی‌بودن

🔹 ذخیره SHA-256 Token به‌جای Token خام

🔹 تاریخ انقضای قابل تنظیم

🔹 مصرف Token فقط در اولین دانلود

🔹 جلوگیری از استفاده هم‌زمان یک Token توسط دو کاربر

🔹 صفحه تأیید قبل از مصرف لینک

🔹 تحویل فایل توسط Nginx به‌جای Python

🔹 اجرای Production با Gunicorn و systemd

User
  |
  | GET /d/TOKEN
  v
Flask
  |
  | Check token + expiration
  v
Confirmation Page
  |
  | POST /d/TOKEN
  v
Atomic consume in SQLite
  |
  | X-Accel-Redirect
  v
Nginx internal location
  |
  v
/srv/private-downloads/file.zip

⚠️ توجه: این روش جلوی تمام Scannerهای پیشرفته را تضمینی نمی‌گیرد، اما احتمال سوختن ناخواسته لینک توسط Preview ساده را بسیار کمتر می‌کند. برای فایل‌های بسیار حساس می‌توان مرحله Login، PIN یا تأیید هویت کاربر را نیز اضافه کرد.

ساخت سیستم دانلود خصوصی روی سرور مجازی ایران

اگر فایل‌ها برای کاربران داخل ایران هستند، می‌توانید Python، Nginx و دیتابیس Token را روی یک سرور مجازی ایران قرار دهید. در این پروژه معمولاً سرعت Disk، فضای ذخیره‌سازی، ترافیک و پهنای باند مهم‌تر از مصرف CPU برنامه Python هستند.

📌 تماس با پشتیبانی:
021-91302460
| ایرانیکاسرور

sudo apt update
sudo apt upgrade -y

sudo apt install python3 python3-venv python3-pip nginx -y

python3 --version

sudo mkdir -p /opt/one-time-download
sudo useradd --system \
  --home /opt/one-time-download \
  --shell /usr/sbin/nologin \
  --gid www-data \
  downloadapp

sudo chown -R downloadapp:www-data /opt/one-time-download

sudo mkdir -p /srv/private-downloads
sudo chown root:www-data /srv/private-downloads
sudo chmod 750 /srv/private-downloads

sudo install \
  -o root \
  -g www-data \
  -m 640 \
  /path/to/manual.pdf \
  /srv/private-downloads/manual.pdf

sudo -u downloadapp python3 -m venv /opt/one-time-download/venv

sudo -u downloadapp 
  /opt/one-time-download/venv/bin/pip 
  install --upgrade pip

sudo -u downloadapp 
  /opt/one-time-download/venv/bin/pip 
  install Flask==3.1.3 gunicorn

sudo nano /opt/one-time-download/app.py

import hashlib
import os
import secrets
import sqlite3
import time
from pathlib import Path
from urllib.parse import quote

import click
from flask import Flask, Response, abort, render_template_string, request


app = Flask(__name__)

BASE_URL = os.getenv(
    "BASE_URL",
    "https://dl.example.com"
).rstrip("/")

FILE_ROOT = Path(
    os.getenv(
        "FILE_ROOT",
        "/srv/private-downloads"
    )
).resolve()

DB_PATH = Path(
    os.getenv(
        "DB_PATH",
        "/opt/one-time-download/data/downloads.db"
    )
)


CONFIRM_TEMPLATE = """
<!doctype html>
<html lang="fa" dir="rtl">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>تأیید دانلود</title>
    <style>
        body {
            font-family: sans-serif;
            background: #f4f7fa;
            color: #243746;
            margin: 0;
            padding: 30px 16px;
        }
        .box {
            max-width: 620px;
            margin: 60px auto;
            background: #fff;
            border: 1px solid #d8e3ed;
            border-radius: 14px;
            padding: 28px;
            box-sizing: border-box;
        }
        h1 {
            font-size: 22px;
            margin-top: 0;
        }
        button {
            border: 0;
            background: #244f7a;
            color: #fff;
            padding: 13px 24px;
            border-radius: 9px;
            cursor: pointer;
            font-size: 15px;
        }
    </style>
</head>
<body>
    <div class="box">
        <h1>لینک دانلود معتبر است</h1>
        <p>فایل: <strong>{{ filename }}</strong></p>
        <p>
            این لینک فقط یک بار قابل استفاده است.
            با شروع دانلود، Token مصرف خواهد شد.
        </p>
        <form method="post">
            <button type="submit">شروع دانلود</button>
        </form>
    </div>
</body>
</html>
"""


def connect_db():
    DB_PATH.parent.mkdir(
        parents=True,
        exist_ok=True
    )

    conn = sqlite3.connect(
        DB_PATH,
        timeout=5
    )

    conn.row_factory = sqlite3.Row

    conn.execute(
        "PRAGMA journal_mode=WAL"
    )

    conn.execute(
        "PRAGMA busy_timeout=5000"
    )

    return conn


def init_db():
    conn = connect_db()

    try:
        conn.execute("""
            CREATE TABLE IF NOT EXISTS download_tokens (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                token_hash TEXT NOT NULL UNIQUE,
                filename TEXT NOT NULL,
                expires_at INTEGER NOT NULL,
                used_at INTEGER,
                created_at INTEGER NOT NULL
            )
        """)

        conn.execute("""
            CREATE INDEX IF NOT EXISTS
            idx_download_tokens_expires
            ON download_tokens(expires_at)
        """)

        conn.commit()

    finally:
        conn.close()


def hash_token(token):
    return hashlib.sha256(
        token.encode("utf-8")
    ).hexdigest()


def validate_filename(filename):
    if not filename:
        raise ValueError("Empty filename")

    path_name = Path(filename)

    if path_name.name != filename:
        raise ValueError(
            "Subdirectories are not allowed"
        )

    full_path = (
        FILE_ROOT / filename
    ).resolve()

    if full_path.parent != FILE_ROOT:
        raise ValueError(
            "Invalid file path"
        )

    if not full_path.is_file():
        raise FileNotFoundError(filename)

    return full_path


def get_valid_token(token):
    token_digest = hash_token(token)
    now = int(time.time())

    conn = connect_db()

    try:
        row = conn.execute("""
            SELECT
                filename,
                expires_at,
                used_at
            FROM download_tokens
            WHERE token_hash = ?
        """, (token_digest,)).fetchone()

    finally:
        conn.close()

    if row is None:
        abort(404)

    if row["used_at"] is not None:
        abort(410)

    if row["expires_at"] <= now:
        abort(410)

    try:
        validate_filename(
            row["filename"]
        )
    except (ValueError, FileNotFoundError):
        abort(404)

    return row


def consume_token(token):
    token_digest = hash_token(token)
    now = int(time.time())

    conn = connect_db()

    try:
        conn.execute(
            "BEGIN IMMEDIATE"
        )

        row = conn.execute("""
            UPDATE download_tokens
            SET used_at = ?
            WHERE token_hash = ?
              AND used_at IS NULL
              AND expires_at > ?
            RETURNING filename
        """, (
            now,
            token_digest,
            now
        )).fetchone()

        if row is None:
            conn.rollback()
            return None

        conn.commit()
        return row

    except Exception:
        conn.rollback()
        raise

    finally:
        conn.close()


@app.route(
    "/d/<token>",
    methods=["GET", "POST"]
)
def download(token):
    if request.method == "HEAD":
        abort(405)

    if request.method == "GET":
        row = get_valid_token(token)

        response = Response(
            render_template_string(
                CONFIRM_TEMPLATE,
                filename=row["filename"]
            ),
            status=200,
            mimetype="text/html"
        )

        response.headers[
            "Cache-Control"
        ] = "no-store"

        response.headers[
            "X-Robots-Tag"
        ] = "noindex, nofollow, noarchive"

        return response

    current = get_valid_token(token)

    try:
        validate_filename(
            current["filename"]
        )
    except (ValueError, FileNotFoundError):
        abort(404)

    consumed = consume_token(token)

    if consumed is None:
        abort(410)

    filename = consumed["filename"]

    internal_uri = (
        "/protected/"
        + quote(filename)
    )

    response = Response(
        status=200
    )

    response.headers[
        "X-Accel-Redirect"
    ] = internal_uri

    response.headers[
        "Content-Type"
    ] = "application/octet-stream"

    response.headers[
        "Content-Disposition"
    ] = (
        "attachment; "
        "filename*=UTF-8''"
        + quote(filename)
    )

    response.headers[
        "Cache-Control"
    ] = "private, no-store"

    response.headers[
        "X-Robots-Tag"
    ] = "noindex, nofollow, noarchive"

    return response


@app.errorhandler(410)
def gone(error):
    return (
        "این لینک منقضی شده یا قبلاً استفاده شده است.",
        410
    )


@app.cli.command("init-db")
def init_db_command():
    init_db()
    click.echo("Database initialized.")


@app.cli.command("create-link")
@click.argument("filename")
@click.option(
    "--minutes",
    default=60,
    show_default=True,
    type=click.IntRange(
        min=1,
        max=525600
    )
)
def create_link(filename, minutes):
    try:
        validate_filename(filename)
    except ValueError as exc:
        raise click.ClickException(
            str(exc)
        )
    except FileNotFoundError:
        raise click.ClickException(
            "File not found."
        )

    token = secrets.token_urlsafe(32)
    token_digest = hash_token(token)

    now = int(time.time())
    expires_at = now + (minutes * 60)

    conn = connect_db()

    try:
        conn.execute("""
            INSERT INTO download_tokens (
                token_hash,
                filename,
                expires_at,
                used_at,
                created_at
            )
            VALUES (?, ?, ?, NULL, ?)
        """, (
            token_digest,
            filename,
            expires_at,
            now
        ))

        conn.commit()

    finally:
        conn.close()

    click.echo(
        f"{BASE_URL}/d/{token}"
    )


@app.cli.command("cleanup")
@click.option(
    "--days",
    default=7,
    show_default=True,
    type=click.IntRange(min=1)
)
def cleanup(days):
    now = int(time.time())
    cutoff = now - (days * 86400)

    conn = connect_db()

    try:
        result = conn.execute("""
            DELETE FROM download_tokens
            WHERE expires_at < ?
               OR (
                    used_at IS NOT NULL
                    AND used_at < ?
               )
        """, (
            cutoff,
            cutoff
        ))

        conn.commit()

        click.echo(
            f"Deleted {result.rowcount} records."
        )

    finally:
        conn.close()

sudo chown downloadapp:www-data \
  /opt/one-time-download/app.py

sudo chmod 640 
  /opt/one-time-download/app.py

token = secrets.token_urlsafe(32)

SHA256(token)

UPDATE download_tokens
SET used_at = ?
WHERE token_hash = ?
  AND used_at IS NULL
  AND expires_at > ?
RETURNING filename

sudo mkdir -p /opt/one-time-download/data
sudo chown downloadapp:www-data \
  /opt/one-time-download/data

cd /opt/one-time-download

sudo -u downloadapp 
  ./venv/bin/flask 
  --app app 
  init-db

Database initialized.

cd /opt/one-time-download

sudo -u downloadapp 
  ./venv/bin/flask 
  --app app 
  run 
  --host 127.0.0.1 
  --port 5000

⚠️ Flask Development Server را برای Production استفاده نکنید. در ادامه برنامه را با Gunicorn و systemd اجرا می‌کنیم.

sudo nano \
  /etc/systemd/system/one-time-download.service

[Unit]
Description=One Time Download Service
After=network.target

[Service]
User=downloadapp
Group=www-data

WorkingDirectory=/opt/one-time-download

Environment="BASE_URL=https://dl.example.com"
Environment="FILE_ROOT=/srv/private-downloads"
Environment="DB_PATH=/opt/one-time-download/data/downloads.db"

RuntimeDirectory=one-time-download
RuntimeDirectoryMode=0750

ExecStart=/opt/one-time-download/venv/bin/gunicorn 
    --workers 2 
    --bind unix:/run/one-time-download/gunicorn.sock 
    --umask 007 
    --access-logfile - 
    --error-logfile - 
    app:app

Restart=on-failure
RestartSec=3

PrivateTmp=true
NoNewPrivileges=true
ProtectHome=true

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now one-time-download
sudo systemctl status one-time-download

sudo nano \
  /etc/nginx/sites-available/one-time-download

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

    location / {
        proxy_pass http://unix:/run/one-time-download/gunicorn.sock;

        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;
    }

    location /protected/ {
        internal;

        alias /srv/private-downloads/;

        add_header X-Content-Type-Options nosniff always;
    }
}

sudo ln -s \
  /etc/nginx/sites-available/one-time-download \
  /etc/nginx/sites-enabled/one-time-download

sudo nginx -t
sudo systemctl reload nginx

https://dl.example.com/protected/manual.pdf

X-Accel-Redirect: /protected/manual.pdf

sudo snap install --classic certbot

sudo ln -s 
  /snap/bin/certbot 
  /usr/local/bin/certbot

sudo certbot --nginx 
  -d dl.example.com

/srv/private-downloads/manual.pdf

cd /opt/one-time-download

sudo -u downloadapp 
  ./venv/bin/flask 
  --app app 
  create-link 
  manual.pdf 
  --minutes 60

https://dl.example.com/d/3jPn7yP86fL9Jk1R...TOKEN...

410 Gone

sudo -u downloadapp \
  ./venv/bin/flask \
  --app app \
  create-link file.zip \
  --minutes 10

sudo -u downloadapp \
  ./venv/bin/flask \
  --app app \
  create-link file.zip \
  --minutes 1440

⚠️ اگر Resume برای شما مهم است: به‌جای Token تک‌مصرف Strict باید مدل Session-Based طراحی کنید. برای مثال Token بعد از اولین کلیک وارد وضعیت active شود و برای چند دقیقه یا برای IP/User مشخص امکان Range Request و Resume داشته باشد؛ سپس پس از پایان Session باطل شود.

cd /opt/one-time-download

sudo -u downloadapp 
  ./venv/bin/flask 
  --app app 
  cleanup 
  --days 7

location /protected/ {
    internal;

    alias /srv/private-downloads/;

    limit_rate_after 5m;
    limit_rate 2m;

    add_header X-Content-Type-Options nosniff always;
}

410 Gone

sudo journalctl \
  -u one-time-download \
  -f

sudo tail -f /var/log/nginx/access.log
sudo tail -f /var/log/nginx/error.log

✅ از secrets و Token تصادفی قوی استفاده کنید.

✅ Token خام را در دیتابیس ذخیره نکنید.

✅ Token را داخل Logهای Application چاپ نکنید.

✅ فایل‌ها را در مسیر public سایت قرار ندهید.

✅ از Nginx internal برای مسیر واقعی فایل استفاده کنید.

✅ HTTPS را اجباری کنید.

✅ زمان اعتبار Token را بیش از نیاز طولانی نکنید.

✅ برنامه را با root اجرا نکنید.

✅ Permission دیتابیس و فایل‌ها را محدود کنید.

✅ برای فایل‌های حساس‌تر Token را به User Account متصل کنید.

sudo systemctl status one-time-download

ls -lah 
  /run/one-time-download/gunicorn.sock

timedatectl

namei -l \
  /srv/private-downloads/manual.pdf

در راه‌اندازی Python، Nginx یا سیستم دانلود مشکل دارید؟

اگر در نصب Python، راه‌اندازی Gunicorn، تنظیم Nginx، SSL، Permission فایل‌ها یا انتخاب VPS مناسب برای دانلودسنتر مشکل دارید، می‌توانید درخواست بررسی و کانفیگ سرور را برای ایرانیکاسرور ارسال کنید.

📌 تماس با پشتیبانی:
021-91302460
| ایرانیکاسرور

جمع‌بندی

برای ساخت لینک دانلود واقعاً یک‌بارمصرف، فقط اضافه کردن Timestamp یا Signature به URL کافی نیست. سرور باید وضعیت Token را نگه دارد تا بتواند تشخیص دهد یک لینک قبلاً مصرف شده است.

در معماری این مقاله Python و Flask مسئول Authentication لینک، SQLite مسئول نگهداری State و Nginx مسئول انتقال سریع فایل است. Token با secrets ساخته می‌شود، فقط Hash آن در دیتابیس قرار می‌گیرد و عملیات مصرف با Transaction اتمیک انجام می‌شود.

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

اگر پروژه بزرگ‌تر شود، همین معماری را می‌توان با PostgreSQL یا Redis، پنل مدیریت Token، API ساخت لینک، محدودیت تعداد دانلود، احراز هویت کاربر، ثبت Audit Log و Session قابل Resume توسعه داد.

منابع رسمی

مستندات رسمی Python secrets برای ساخت Token امن

مستندات رسمی Flask

مستندات رسمی Nginx درباره internal و X-Accel-Redirect

مستندات رسمی SQLite RETURNING