Files
TeleUploader/README.md
T

1.9 KiB

Telegram Bot Uploader Backend

Backend production-ready untuk upload file ke Telegram yang tersimpan di private channel.

Setup

  1. Siapkan PostgreSQL database (produksi: database uploader via PgBouncer pool di 100.121.180.82:6432)
  2. Setup environment: cp .env.example .env
  3. Edit .env dengan nilai yang sesuai (lihat DATABASE_URL, PORT=4000)
  4. Create table: bun run db:migrate
  5. Install dependencies: bun install

Telegram Private Channel Setup

  1. Buat private channel Telegram
  2. Tambah bot sebagai admin di channel
  3. Dapatkan STORAGE_CHANNEL_ID (misalnya -1001234567890)

Running

bun run dev      # Development mode
bun run start    # Production mode

Deployment (Produksi — Nix + systemd)

Infra lama berbasis Docker + Traefik sudah dihapus dari orangevps (2026-08-02).

  • Host: orangevps
  • Service: systemd unit teleuploader (env via /etc/teleuploader/env / BWS secrets)
  • Build: Nix flake (flake.nix) — nix build .#teleuploadernix copysystemctl restart teleuploader
  • CI: .github/workflows/deploy.yml (Gitea Actions / GitHub Actions)
  • Port: 4000 (PORT env)
  • Domain: https://upload.asepharyana.my.id
  • Reverse proxy: Caddy (bukan Traefik/Docker)
  • Database: postgresql://asephs:***@100.121.180.82:6432/uploader (PgBouncer pool di imrnes, bukan 5432/localhost)
  • deploy.sh & Dockerfile & docker-compose.yml bersifat legacy — jangan dipakai untuk deploy produksi.

API Endpoints

  • POST /api/upload - Upload file
  • GET /f/:public_id - Download redirect
  • GET /file/:public_id/info - File metadata
  • GET /health - Health check

FAQ

URL permanen maksudnya apa? URL backend tetap permanen: https://upload.asepharyana.my.id/f/{public_id} Ini berarti URL service Anda fix, bukan jaminan file Telegram abadi.

Testing

Gunakan bot Telegram untuk upload, atau upload API langsung via HTTP.