| Ortam Değişkeni | Açıklama | Varsayılan Değer | Zorunlu | Örnek |
|---|---|---|---|---|
| Temel Yapılandırma | ||||
| PUBLIC_ORIGIN | Tam URL’ler oluşturmak için kullanılan genel kaynak; uygulamanızın erişim adresi olarak ayarlanmalıdır | - | Evet | https://app.teable.ai |
| SECRET_KEY | JWT’ler, oturumlar ve paylaşımlar için kök gizli anahtar. Güçlü ve rastgele bir değer oluşturun | - | Evet | openssl rand -base64 32 |
| BACKEND_JWT_SECRET | Kimlik doğrulama, paylaşım ve eklenti JWT’lerini imzalar. Ayarlanmazsa SECRET_KEY kullanılır | SECRET_KEY | - | openssl rand -base64 32 |
| BACKEND_SESSION_SECRET | Oturum açma çerezlerini imzalar. Ayarlanmazsa SECRET_KEY kullanılır | SECRET_KEY | - | openssl rand -base64 32 |
| BACKEND_STORAGE_ENCRYPTION_KEY | Ek erişim belirteçlerini şifreler. BACKEND_STORAGE_PROVIDER local olduğunda zorunludur | - | Evet | 16 karakterli rastgele dize |
| BACKEND_STORAGE_ENCRYPTION_IV | BACKEND_STORAGE_ENCRYPTION_KEY ile eşleştirilen şifreleme IV değeri | - | Evet | 16 karakterli rastgele dize |
| BACKEND_ACCESS_TOKEN_ENCRYPTION_KEY | Kişisel erişim belirteçlerini şifreler | - | Evet | 16 karakterli rastgele dize |
| BACKEND_ACCESS_TOKEN_ENCRYPTION_IV | BACKEND_ACCESS_TOKEN_ENCRYPTION_KEY ile eşleştirilen şifreleme IV değeri | - | Evet | 16 karakterli rastgele dize |
| PORT | Uygulamanın çalıştığı bağlantı noktası | 3000 | - | 3000 |
| LOG_LEVEL | Günlük düzeyi; seçenekler: fatal, error, warn, info, debug, trace | info | - | debug |
| Depolama Yapılandırması | ||||
| BACKEND_STORAGE_PROVIDER | Depolama sağlayıcısı; seçenekler: local, minio, s3, aliyun | local | - | s3 |
| BACKEND_STORAGE_LOCAL_PATH | Yerel depolama yolu | .assets/uploads | - | .assets/uploads |
| BACKEND_STORAGE_PUBLIC_BUCKET | Genel bucket adı | public | - | teable-public |
| BACKEND_STORAGE_PRIVATE_BUCKET | Ekler, uygulama dosyaları, arşivlenmiş veriler ve diğer korunan içerikler için özel bucket adı | private | - | teable-private |
| BACKEND_STORAGE_PUBLIC_URL | Genel bucket için isteğe bağlı genel URL geçersiz kılma değeri | - | - | https://cdn.example.com |
| BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT | Özel bucket uç noktası için isteğe bağlı geçersiz kılma değeri | - | - | https://private-bucket.endpoint |
| BACKEND_STORAGE_S3_REGION | S3 depolama bölgesi; BACKEND_STORAGE_PROVIDER s3 olduğunda zorunludur | - | - | us-east-2 |
| BACKEND_STORAGE_S3_ENDPOINT | S3 depolama uç noktası; BACKEND_STORAGE_PROVIDER s3 olduğunda zorunludur | - | - | https://s3.us-east-2.amazonaws.com |
| BACKEND_STORAGE_S3_INTERNAL_ENDPOINT | İsteğe bağlı dahili S3 uç noktası | - | - | http://s3.internal |
| BACKEND_STORAGE_S3_FORCE_PATH_STYLE | Tarayıcıya yönelik S3 isteklerinde yol biçimli URL’ler (endpoint/bucket/key) kullanır. Genel uç nokta bucket alt alan adlarını sunamıyorsa etkinleştirin. BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT ile birlikte kullanılamaz | false | - | true |
| BACKEND_STORAGE_S3_INTERNAL_FORCE_PATH_STYLE | Dahili S3 isteklerinde yol biçimli adreslemeyi geçersiz kılar. Ayarlanmadığında, iki istemci aynı uç noktayı paylaşıyorsa genel ayarı devralır; ayrı bir dahili uç nokta sanal ana bilgisayar biçimli adreslemeyi korur | - | - | true |
| BACKEND_STORAGE_S3_ACCESS_KEY | S3 depolama erişim anahtarı; BACKEND_STORAGE_PROVIDER s3 olduğunda zorunludur | - | - | your_access_key |
| BACKEND_STORAGE_S3_SECRET_KEY | S3 depolama gizli anahtarı; BACKEND_STORAGE_PROVIDER s3 olduğunda zorunludur | - | - | your_secret_key |
| BACKEND_STORAGE_S3_MAX_SOCKETS | İsteğe bağlı en yüksek S3 soket sayısı | 100 | - | 100 |
| BACKEND_STORAGE_MINIO_ENDPOINT | MinIO depolama uç noktası | - | - | minio.example.com |
| BACKEND_STORAGE_MINIO_PORT | MinIO bağlantı noktası | 9000 | - | 443 |
| BACKEND_STORAGE_MINIO_USE_SSL | MinIO’nun SSL kullanıp kullanmadığı | false | - | true |
| BACKEND_STORAGE_MINIO_ACCESS_KEY | MinIO erişim anahtarı | - | - | access-key |
| BACKEND_STORAGE_MINIO_SECRET_KEY | MinIO gizli anahtarı | - | - | secret-key |
| BACKEND_STORAGE_MINIO_INTERNAL_ENDPOINT | İsteğe bağlı dahili MinIO uç noktası; HTTPS desteklenmez | - | - | minio.internal |
| BACKEND_STORAGE_MINIO_INTERNAL_PORT | İsteğe bağlı dahili MinIO bağlantı noktası | 9000 | - | 9000 |
| BACKEND_STORAGE_MINIO_REGION | İsteğe bağlı MinIO bölgesi | - | - | us-east-1 |
| BACKEND_STORAGE_UPLOAD_METHOD | Yükleme yöntemi | put | - | put |
| STORAGE_PREFIX | Depolama öneki; varsayılan olarak PUBLIC_ORIGIN kullanılır | PUBLIC_ORIGIN | - | http://localhost:3000 |
| Önbellek Yapılandırması | ||||
| BACKEND_CACHE_PROVIDER | Önbellek sağlayıcısı; seçenekler: sqlite, memory, redis | sqlite | - | redis |
| BACKEND_CACHE_REDIS_URI | Hesaplanan görevlerin iletilmesi için zorunlu Redis bağlantı URI’si; BACKEND_CACHE_PROVIDER redis olduğunda önbellek için de kullanılır | - | Evet | redis://default:teable@127.0.0.1:6379/0 |
| Performans Önbelleği Yapılandırması | ||||
| BACKEND_PERFORMANCE_CACHE | Sorgu sonuçlarını önbelleğe almak için performans önbelleği Redis URL’si; çok kullanıcılı işbirliği verimliliğini artırır. BACKEND_CACHE_REDIS_URI’den ayrı bir Redis örneği kullanılması önerilir | - | - | redis://default:teable@127.0.0.1:6379/0 |
| Kimlik Doğrulama Yapılandırması | ||||
| SOCIAL_AUTH_PROVIDERS | Virgülle ayrılmış sosyal kimlik doğrulama sağlayıcıları listesi | - | - | github,google,oidc |
| BACKEND_GITHUB_CLIENT_ID | GitHub OAuth istemci kimliği | - | - | github_client_id |
| BACKEND_GITHUB_CLIENT_SECRET | GitHub OAuth istemci gizli anahtarı | - | - | github_client_secret |
| BACKEND_GOOGLE_CLIENT_ID | Google OAuth istemci kimliği | - | - | google_client_id |
| BACKEND_GOOGLE_CLIENT_SECRET | Google OAuth istemci gizli anahtarı | - | - | google_client_secret |
| BACKEND_OIDC_CLIENT_ID | OIDC istemci kimliği | - | - | google_client_id |
| BACKEND_OIDC_CLIENT_SECRET | OIDC istemci gizli anahtarı | - | - | google_client_secret |
| BACKEND_OIDC_CALLBACK_URL | OIDC geri çağırma URL’si | - | - | https://app.teable.ai/api/auth/oidc/callback |
| Güvenlik ve Doğrulama | ||||
| TURNSTILE_SITE_KEY | Kimlik doğrulama denetimi için Cloudflare Turnstile site anahtarı | - | - | 1x00000000000000000000AA |
| TURNSTILE_SECRET_KEY | Kimlik doğrulama denetimi için Cloudflare Turnstile gizli anahtarı | - | - | 1x0000000000000000000000000000000AA |
| TEABLE_SSRF_PROTECTION_DISABLED | Geri döngü, özel, bağlantı-yerel ve diğer ayrılmış ağ adreslerine giden istekleri engelleyen korumayı devre dışı bırakır. Yalnızca dahili uç noktalara erişmesi gereken güvenilir, kendi sunucunuzda barındırılan dağıtımlarda true olarak ayarlayın | false | - | true |
| BACKEND_SIGNUP_VERIFICATION_CODE_RATE_LIMIT_SECONDS | Kayıt doğrulama e-postalarının gönderilmesi için hız sınırı aralığı (saniye) | - | - | 30 |
| BACKEND_TRUST_PROXY | Bir proxy arkasındaki istemci IP’sini belirlemek için kullanılan ters proxy güven ayarı. Denetim günlüklerini ve ilgili güvenlik kayıtlarını etkiler. true, false, atlama sayısı veya IP/CIDR/ön ayar listesi kabul eder. Boş bırakıldığında özel ağ proxy’lerine güvenilir | loopback, linklocal, uniquelocal | - | loopback, linklocal, uniquelocal |
| E-posta Yapılandırması (Kullanımdan Kaldırıldı - Yönetici Paneli > Örnek ayarları > E-posta bölümünü kullanın) | ||||
| BACKEND_MAIL_HOST | Varsayılan posta sunucusu adresi. Bildirim e-postasını ve Otomasyon e-postasını Yönetici Paneli > Örnek ayarları > E-posta bölümünden görsel olarak yapılandırmanızı öneririz | smtp.teable.ai | - | smtp.gmail.com |
| BACKEND_MAIL_PORT | Varsayılan posta sunucusu bağlantı noktası | 465 | - | 465 |
| BACKEND_MAIL_SECURE | Varsayılan posta hizmetinin SSL/TLS kullanıp kullanmadığı | true | - | true |
| BACKEND_MAIL_SENDER | Varsayılan gönderen adresi | noreply.teable.ai | - | noreply@company.com |
| BACKEND_MAIL_SENDER_NAME | Varsayılan gönderen adı | Teable | - | Teable |
| BACKEND_MAIL_AUTH_USER | Varsayılan posta sunucusu kimlik doğrulama kullanıcı adı | - | - | username |
| BACKEND_MAIL_AUTH_PASS | Varsayılan posta sunucusu kimlik doğrulama parolası | - | - | usertoken |
| BACKEND_MAIL_INVITE_USER_NAME_MAX_LENGTH | Davet e-postası konularında davet eden kişinin adının en fazla uzunluğu. Boş değer veya 0, kısaltmayı devre dışı bırakır | - | - | 32 |
| BACKEND_MAIL_INVITE_SPACE_NAME_MAX_LENGTH | Davet e-postası konularında Alan veya Veritabanı adının en fazla uzunluğu. Boş değer veya 0, kısaltmayı devre dışı bırakır | - | - | 32 |
| Oturum/JWT Yapılandırması | ||||
| BACKEND_SESSION_EXPIRES_IN | Oturum sona erme süresi | 7d | - | 7d |
| BACKEND_SESSION_COOKIE_SECURE | Oturum çerezinin güvenli olup olmadığı | false | - | true |
| BACKEND_SESSION_ORIGIN_CHECK_ENABLED | Güvenli olmayan tarayıcı oturum çerezi API isteklerinde Origin ve Fetch Metadata kontrollerini etkinleştirir. Yalnızca ters proxy’niz veya CDN’niz bu üstbilgileri koruyorsa etkinleştirin | false | - | false |
| BACKEND_JWT_EXPIRES_IN | JWT sona erme süresi | 20d | - | 20d |
| BACKEND_RESET_PASSWORD_EMAIL_EXPIRES_IN | Parola sıfırlama e-postasının sona erme süresi | 30m | - | 30m |
| Kaynak Sınırları | ||||
| MAX_COPY_CELLS | Tek bir istekte kopyalanabilecek en fazla hücre sayısı | - | - | 50000 |
| MAX_READ_ROWS | Tek bir istekte okunabilecek en fazla satır sayısı | - | - | 10000 |
| MAX_ATTACHMENT_UPLOAD_SIZE | En büyük ek yükleme boyutu (bayt) | - | - | 2147483648 |
| TASK_MAX_FIELDS_PER_BATCH | Tek bir toplu istekte modele gönderilen en fazla AI alanı sayısı. Değerler 1 ile 20 arasına sınırlandırılır | 5 | - | 5 |
| TASK_MAX_CONCURRENCY | Bir zamanlama döngüsünde gönderilen, bekleyen en fazla AI alanı görevi çalıştırma sayısı. Değerler 1 ile 20 arasına sınırlandırılır | 5 | - | 5 |
| TABLE_LIMIT_FIELD_OPTIONS_MAX_BYTES | Serileştirilmiş alan seçeneklerinin en fazla bayt sayısı | 262144 | - | 262144 |
| TABLE_LIMIT_SELECT_CHOICES_MAX | Seçim alanı başına en fazla seçim seçeneği | 1000 | - | 1000 |
| TABLE_LIMIT_SELECT_CHOICE_NAME_MAX_LENGTH | Seçim seçeneği adının en fazla uzunluğu | 1000 | - | 1000 |
| TABLE_LIMIT_SELECT_DEFAULT_VALUES_MAX | En fazla varsayılan seçim değeri | 100 | - | 100 |
| TABLE_LIMIT_CELL_VALUE_MAX_BYTES | Hücre değerinin en fazla bayt sayısı | 262144 | - | 262144 |
| TABLE_LIMIT_RECORD_FIELDS_MAX_BYTES | Serileştirilmiş kayıt alanlarının en fazla bayt sayısı | 1048576 | - | 1048576 |
| TABLE_LIMIT_RECORDS_PER_MUTATION_MAX | Değişiklik işlemi başına en fazla kayıt sayısı | 20000 | - | 20000 |
| TABLE_LIMIT_COMPUTED_CELL_VALUE_MAX_BYTES | Hesaplanan hücre değerinin en fazla bayt sayısı | 262144 | - | 262144 |
| TABLE_LIMIT_FORMULA_MAX_LENGTH | Formülün en fazla uzunluğu | 8192 | - | 8192 |
| TABLE_LIMIT_TABLES_PER_BASE_MAX | Veritabanı başına en fazla tablo sayısı | 1000 | - | 1000 |
| TABLE_LIMIT_FIELDS_PER_TABLE_MAX | Tablo başına en fazla alan sayısı | 500 | - | 500 |
| TABLE_LIMIT_VIEWS_PER_TABLE_MAX | Tablo başına en fazla görünüm sayısı | 100 | - | 100 |
| TABLE_LIMIT_CREATE_TABLE_FIELDS_MAX | Tablo oluştururken kabul edilen en fazla alan sayısı | 1000 | - | 1000 |
| TABLE_LIMIT_CREATE_TABLE_VIEWS_MAX | Tablo oluştururken kabul edilen en fazla görünüm sayısı | 20 | - | 20 |
| TABLE_LIMIT_CREATE_TABLE_RECORDS_MAX | Tablo oluştururken kabul edilen en fazla kayıt sayısı | 20000 | - | 20000 |
| TABLE_LIMIT_RECORDS_PER_TABLE_MAX | Tablo başına en fazla satır sayısı. Boş bırakılması, örnek düzeyinde satır sınırı olmadığı anlamına gelir | - | - | 1000000 |
| TABLE_LIMIT_VIEW_FILTER_ITEMS_MAX | Bir görünümde en fazla filtre öğesi | 100 | - | 100 |
| TABLE_LIMIT_VIEW_FILTER_DEPTH_MAX | Bir görünümde en fazla iç içe filtre derinliği | 5 | - | 5 |
| TABLE_LIMIT_VIEW_SORT_ITEMS_MAX | Bir görünümde en fazla sıralama öğesi | 20 | - | 20 |
| TABLE_LIMIT_VIEW_GROUP_ITEMS_MAX | Bir görünümde en fazla gruplama öğesi | 3 | - | 3 |
| TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTES | Serileştirilmiş görünüm seçeneklerinin en fazla bayt sayısı | 262144 | - | 262144 |
| TABLE_LIMIT_NAME_MAX_LENGTH | Desteklenen tablo nesnelerinin görünen adının en fazla uzunluğu | 100 | - | 100 |
| TABLE_LIMIT_DESCRIPTION_MAX_LENGTH | Desteklenen tablo nesnelerinin açıklamasının en fazla uzunluğu | 2000 | - | 2000 |
| AUTOMATION_MIN_SCHEDULED_MINUTES_INTERVAL | Dakika sıklığındaki zamanlanmış bir tetikleyicinin kullanabileceği en kısa aralık (dakika). Dakika düzeyindeki zamanlamaları devre dışı bırakmak için 60’ın üzerinde ayarlayın | 10 | - | 15 |
| AUTOMATION_MIN_EMAIL_POLL_INTERVAL_MINUTES | Bir e-posta tetikleyicisinin kullanabileceği en kısa posta kutusu yoklama aralığı (dakika) | 10 | - | 15 |
| AI ve App Builder (çalışma zamanı katmanı bağlantısı) | ||||
| SANDBOX_PROVIDER | AI oturumları için korumalı alan sağlayıcısı; opensandbox, kendi sunucunuzda barındırılan bir çalışma zamanı katmanına bağlanır | - | - | opensandbox |
| TEABLE_INFRA_API_URL | Çalışma zamanı katmanı giriş URL’si — dahili hizmet adresi değil, genel giriş olmalıdır (/v1 yolunu korumalı alan motoruna yönlendirir) | - | - | https://infra.teable.example.com |
| TEABLE_INFRA_API_KEY | Çalışma zamanı katmanıyla paylaşılan API anahtarı | - | - | your-infra-api-key |
| TEABLE_INFRA_BUCKET | AI çalışma alanı veri katmanı için bucket | teable-agent | - | teable-agent |
| SANDBOX_OPENSANDBOX_IMAGE | Korumalı alan aracısı imajının etiketsiz öneki — Teable kendi sürüm etiketini ekler; böylece aracı sürümü her zaman uygulamayla eşleşir. Çin dağıtımlarında Aliyun ayna öneki kullanılır | - | - | ghcr.io/teableio/teable-sandbox-agent |
| SANDBOX_OPENSANDBOX_RUNTIME | Korumalı alan motorunun çalışma zamanı türü: kubernetes veya docker. Docker dağıtımlarında docker olmalıdır | kubernetes | - | docker |
| SANDBOX_OPENSANDBOX_USE_SERVER_PROXY | Korumalı alan uç noktalarını bağlantı noktası başına alt alan adları yerine motorun yol tabanlı proxy’si üzerinden yönlendirir (Docker yerel modunda kullanılır) | false | - | true |
| APP_DEPLOY_PROVIDER | App Builder dağıtım arka ucu; tam özellikli kendi sunucunda barındırma için docker-runtime kullanılır | vercel | - | docker-runtime |
| SANDBOX_JWT_SECRET | Korumalı alan oturumlarını imzalayan gizli anahtar. Her ana bilgisayar için rastgele bir değer oluşturun ve korumalı alan hizmetinde aynı değeri kullanın | - | Evet | rastgele dize |
| SANDBOX_CPU | Korumalı alan başına vCPU (yönetici paneli ayarları önceliklidir) | 2 | - | 2 |
| SANDBOX_MEMORY | Korumalı alan başına bellek (GiB) (yönetici paneli ayarları önceliklidir) | 4 | - | 4 |
| SANDBOX_DISK | Korumalı alan başına geçici disk (GiB) (yönetici paneli ayarları önceliklidir) | 15 | - | 15 |
| Özellik Anahtarları | ||||
| RECORD_HISTORY_DISABLED | Kayıt geçmişinin devre dışı bırakılıp bırakılmayacağı; varsayılan değer false’tur | false | - | true |
| BACKEND_STORAGE_COLD_ARCHIVE_DISABLED | Geçmiş verilerin zamanlanmış arşivlenmesini durdurup durdurmayacağı. Daha önce arşivlenen veriler okunabilir kalır | false | - | true |
| PASSWORD_LOGIN_DISABLED | Parolayla oturum açmanın devre dışı bırakılıp bırakılmayacağı (OAuth ve OIDC kullanılabilir olmaya devam eder) | false | - | true |
| Analiz ve İzleme | ||||
| MICROSOFT_CLARITY_ID | Microsoft Clarity analizlerini etkinleştirmek için Microsoft Clarity ölçüm kimliği | - | - | your-metrics-id |
| OTEL_EXPORTER_OTLP_ENDPOINT | OpenTelemetry OTLP uç noktası | - | - | http://jaeger:4317 |
| TELEMETRY_REPORT_DISABLED | Bağlı örneklerden gelen lisans uyumluluğu raporları dahil, kendi sunucusunda barındırma telemetrisi raporlamasını devre dışı bırakır | false | - | true |
| Veritabanı Yapılandırması | ||||
| PRISMA_DATABASE_URL | Veritabanı bağlantı URL’si; yapılandırılması zorunludur | - | Evet | postgresql://teable:teable@127.0.0.1:5432/teable |
| PUBLIC_DATABASE_PROXY | Veritabanı “Veritabanı Bağlantısı” panelinde oluşturulan kimlik bilgilerinde kullanılan, dışarıdan erişilebilir veritabanı adresi (ana bilgisayar:bağlantı noktası); harici salt okunur SQL erişimini etkinleştirmek için ayarlayın | - | - | db.example.com:42345 |
| PRISMA_TRANSACTION_TIMEOUT | Bir işlemin zaman aşımına uğramadan önce çalışabileceği en uzun süre (ms). Uzun süren işlemler için artırın (ör. çok sayıda yabancı anahtar içeren toplu güncellemeler) | 5000 | - | 60000 |
| PRISMA_TRANSACTION_MAX_WAIT | Havuzdan bir işlem edinmek için beklenecek en uzun süre (ms) | 2000 | - | 5000 |
| BIG_TRANSACTION_TIMEOUT | Büyük Veritabanlarının dışa aktarılması gibi büyük dahili işlemler için zaman aşımı (ms) | 600000 | - | 1200000 |
Gizli anahtarlar ve döndürme
Yukarıda gizli anahtar olarak işaretlenen her değer kendi yapılandırmanızdan gelmelidir. Sunucu bu değerleri başlangıçta bir kez denetler ancak eksik bir gizli anahtar başlatmayı engellemez: Teable, eski sürümlerde yerleşik olan varsayılan değeri kullanır, eksik değişkenleri günlüğe kaydeder ve başlatılır. Bu yerleşik değerler herkese açıktır; dolayısıyla herkes bunlarla belirteç oluşturabilir veya korunan verilerin şifresini çözebilir. Bu yalnızca hızlı bir yerel deneme için kabul edilebilir, diğer tüm kullanımlar için güvensizdir. Mevcut bir dağıtımı yükseltme. Bu değişkenler olmadan çalışan bir örnek, eski yerleşik değerleri örtük olarak kullanıyordu ve hâlâ kullanmaktadır. Başlangıç uyarısı, mevcut oturumların, belirteçlerin ve şifrelenmiş verilerin çalışmaya devam etmesi için eklemeniz gereken bloğu eksiksiz olarak gösterir. Bloğu olduğu gibi kopyalayıp yeniden başlatın, ardından anahtarları döndürmeyi planlayın. Yapılandırma biçiminiz gerektiriyorsa değerlerdeki$ karakterini kaçırmayı unutmayın.
Yeni dağıtım. Bunun yerine yeni değerler oluşturun:
openssl rand -base64 32
*_ENCRYPTION_KEY ve *_ENCRYPTION_IV alanları için
openssl rand -hex 8 komutunu kullanın.
Başlangıç günlüğü, bir gizli anahtarın daha önce kullanılmış ve herkese açık olduğu
bilinen varsayılan bir değere açıkça ayarlanması durumunda da uyarı verir. Verilerinize
erişilebilmesi için örnek çalışmayı sürdürür; ancak herkes bu değerle belirteç oluşturabilir
veya korunan verilerin şifresini çözebilir. Anahtarı döndürün.