Files
2026-07-13 12:30:54 +08:00

6.6 KiB

sidebar_position, _i18n_hash
sidebar_position _i18n_hash
10 a89f05aed50f89d55367e4d1d6598373

Variabel Lingkungan

Tianji mendukung berbagai variabel lingkungan untuk menyesuaikan perilakunya. Anda dapat mengkonfigurasi variabel ini di bidang env dalam docker compose atau melalui lingkungan penerapan Anda.

Konfigurasi Dasar

Variabel Deskripsi Default Contoh
PORT Port server 12345 3000
JWT_SECRET Rahasia untuk token JWT Teks Acak your-secret-key
ALLOW_REGISTER Izinkan pendaftaran pengguna false true
ALLOW_OPENAPI Izinkan akses OpenAPI true false
WEBSITE_ID Identifikasi situs web - your-website-id
DISABLE_AUTO_CLEAR Nonaktifkan pembersihan data otomatis false true
DISABLE_ACCESS_LOGS Nonaktifkan log akses false true
DB_DEBUG Aktifkan debugging basis data false true
ALPHA_MODE Aktifkan fitur alpha false true
ENABLE_FUNCTION_WORKER Aktifkan pekerja fungsi false true
REGISTER_AUTO_JOIN_WORKSPACE_ID ID ruang kerja untuk pengguna baru - workspace-id-123

Konfigurasi Cache

Variabel Deskripsi Default Contoh
CACHE_MEMORY_ONLY Gunakan cache hanya di memori false true
REDIS_URL URL koneksi Redis - redis://localhost:6379

Autentikasi

Variabel Deskripsi Default Contoh
DISABLE_ACCOUNT Nonaktifkan autentikasi berbasis akun false true
AUTH_SECRET Rahasia autentikasi MD5 dari rahasia JWT your-auth-secret
AUTH_RESTRICT_EMAIL Batasi pendaftaran ke domain email tertentu - @example.com
AUTH_USE_SECURE_COOKIES Gunakan cookies aman untuk autentikasi false true

Autentikasi Email dan Undangan Email

Variabel Deskripsi Default Contoh
EMAIL_SERVER Server SMTP untuk email - smtp://user:pass@smtp.example.com:587
EMAIL_FROM Alamat pengirim email - noreply@example.com

Autentikasi GitHub

Variabel Deskripsi Default Contoh
AUTH_GITHUB_ID ID klien OAuth GitHub - your-github-client-id
AUTH_GITHUB_SECRET Rahasia klien OAuth GitHub - your-github-client-secret

Autentikasi Google

Variabel Deskripsi Default Contoh
AUTH_GOOGLE_ID ID klien OAuth Google - your-google-client-id
AUTH_GOOGLE_SECRET Rahasia klien OAuth Google - your-google-client-secret

Autentikasi OAuth/OIDC Kustom

Variabel Deskripsi Default Contoh
AUTH_CUSTOM_ID ID klien OAuth/OIDC Kustom - your-custom-client-id
AUTH_CUSTOM_SECRET Rahasia klien OAuth/OIDC Kustom - your-custom-client-secret
AUTH_CUSTOM_NAME Nama penyedia kustom Custom Enterprise SSO
AUTH_CUSTOM_TYPE Jenis autentikasi oidc oauth
AUTH_CUSTOM_ISSUER URL penerbit OIDC - https://auth.example.com

Fitur AI

Variabel Deskripsi Default Contoh
SHARED_OPENAI_API_KEY Kunci API OpenAI - your-openai-api-key
SHARED_OPENAI_BASE_URL URL API OpenAI Kustom - https://api.openai.com/v1
SHARED_OPENAI_MODEL_NAME Model OpenAI yang digunakan gpt-4o gpt-3.5-turbo
SHARED_OPENAI_TOKEN_CALC_CONCURRENCY Konkurensi kalkulasi token 5 10
DEBUG_AI_FEATURE Debug fitur AI false true

Konfigurasi ClickHouse

Variabel Deskripsi Default Contoh
CLICKHOUSE_URL URL basis data ClickHouse - http://localhost:8123
CLICKHOUSE_USER Nama pengguna ClickHouse - default
CLICKHOUSE_PASSWORD Kata sandi ClickHouse - your-password
CLICKHOUSE_DATABASE Nama basis data ClickHouse - tianji
CLICKHOUSE_DEBUG Aktifkan debugging ClickHouse false true
CLICKHOUSE_DISABLE_SYNC Nonaktifkan sinkronisasi ClickHouse false true
CLICKHOUSE_SYNC_BATCH_SIZE Ukuran batch sinkronisasi 10000 5000
CLICKHOUSE_ENABLE_FALLBACK Aktifkan fallback ClickHouse true false
CLICKHOUSE_HEALTH_CHECK_INTERVAL Interval pengecekan kesehatan (ms) 30000 60000
CLICKHOUSE_MAX_CONSECUTIVE_FAILURES Maksimum kegagalan berturut-turut 3 5
CLICKHOUSE_RETRY_INTERVAL Interval percobaan ulang (ms) 5000 10000

Sistem Penagihan (LemonSqueezy)

Variabel Deskripsi Default Contoh
ENABLE_BILLING Aktifkan fungsionalitas penagihan false true
LEMON_SQUEEZY_SIGNATURE_SECRET Rahasia tanda tangan webhook LemonSqueezy - your-signature-secret
LEMON_SQUEEZY_API_KEY Kunci API LemonSqueezy - your-api-key
LEMON_SQUEEZY_STORE_ID ID toko LemonSqueezy - your-store-id
LEMON_SQUEEZY_SUBSCRIPTION_FREE_ID ID varian langganan tier gratis - free-variant-id
LEMON_SQUEEZY_SUBSCRIPTION_PRO_ID ID varian langganan tier pro - pro-variant-id
LEMON_SQUEEZY_SUBSCRIPTION_TEAM_ID ID varian langganan tier tim - team-variant-id

Konfigurasi Sandbox

Variabel Deskripsi Default Contoh
USE_VM2 Gunakan VM2 untuk eksekusi sandbox false true
SANDBOX_MEMORY_LIMIT Batas memori sandbox (MB) 16 32
PUPPETEER_EXECUTABLE_PATH Jalur kustom ke eksekusi Puppeteer - /usr/bin/chromium

Integrasi Peta

Variabel Deskripsi Default Contoh
AMAP_TOKEN Token API AMap (Gaode) - your-amap-token
MAPBOX_TOKEN Token API Mapbox - your-mapbox-token

Telemetri

Variabel Deskripsi Default Contoh
DISABLE_ANONYMOUS_TELEMETRY Nonaktifkan telemetri anonim false true
CUSTOM_TRACKER_SCRIPT_NAME Nama skrip pelacak kustom - custom-tracker.js

Menetapkan Variabel Lingkungan

Anda dapat menetapkan variabel lingkungan ini dengan beberapa cara:

  1. Set langsung di lingkungan penerapan Anda (Docker, Kubernetes, dll.)

  2. Untuk penerapan Docker, Anda dapat menggunakan variabel lingkungan di docker-compose.yml Anda:

services:
  tianji:
    image: moonrailgun/tianji:latest
    environment:
      - PORT=3000
      - ALLOW_REGISTER=true

Nilai Boolean

Untuk variabel lingkungan boolean, Anda dapat menggunakan "1" atau "true" untuk mengaktifkan fitur, dan mengabaikan variabel atau mengesetnya ke nilai lain untuk menonaktifkannya.