Власні домени для опублікованих застосунків у самостійно розгорнутому Teable

Кожен застосунок, який ви публікуєте за допомогою App Builder, отримує власну адресу в домені вашого розгортання:

https://<name>.app.<your-domain>      наприклад https://crm.app.teable.example.com

Ця адреса вже розміщена у вашому власному домені. Змінити її можна двома способами:

Що потрібно	Хто це робить	Розділ
Зрозуміла назва, наприклад `crm.app.teable.example.com` замість випадкового ID	Будь-хто, хто може редагувати застосунок, — у редакторі застосунків	Перейменування посилання доступу
Повністю окремий домен, наприклад `crm.example.org`	Адміністратор вашого сервера, один раз для кожного домену	Розміщення застосунку на окремому домені

Перейменування посилання доступу

Нова назва починає працювати одразу, змінювати DNS чи сертифікати не потрібно.

Відкрийте застосунок у редакторі застосунків і натисніть Опублікувати.
Поруч із полем Посилання доступу натисніть значок редагування.
Введіть нову назву (малі латинські літери, цифри й дефіси; назва має починатися й закінчуватися літерою або цифрою) і натисніть Підтвердити.

Панель публікації опублікованого застосунку: значок редагування поруч із посиланням доступу, а потім поле назви з кнопками скасування й підтвердження

Тепер застосунок доступний за адресою https://<new-name>.app.<your-domain>. Якщо ви вже перейменовували його раніше, попередня назва перестає працювати, тож оновіть посилання, якими ви поділилися.

Розміщення застосунку на окремому домені

Цей спосіб потрібен, коли застосунок має працювати поза вашим доменом Teable, наприклад клієнтський портал на portal.example.org. Відвідувачі весь час бачать в адресному рядку ваш домен: жодних переспрямувань не відбувається.

Шлях запиту: відвідувач відкриває portal.example.org, DNS спрямовує його на ваш сервер Teable, а сервер передає запит застосунку, опублікованому за адресою portal.app.teable.example.com

Що знадобиться:

Реліз платформи v2026.11.5 або новіший (журнал змін). Щоб після входу відвідувачі поверталися на цей домен, потрібен також реліз Teable від 2026-11-05 або новіший.
Поточне посилання доступу застосунку, наприклад portal.app.teable.example.com.
Доступ до налаштувань DNS окремого домену.
Доступ до сервера (Docker) або до Helm values (Kubernetes) вашого розгортання.

Крок 1. Спрямуйте домен на своє розгортання

Додайте для окремого домену один DNS-запис:

Домен	Запис
Піддомен, наприклад `portal.example.org`	`CNAME` → посилання доступу застосунку, наприклад `portal.app.teable.example.com`
Кореневий домен, наприклад `example.org`	`A` → публічна IP-адреса вашого сервера (або балансувальника навантаження Ingress). Більшість DNS-провайдерів не дозволяють `CNAME` для кореневого домену.

Перш ніж продовжити, перевірте запис: команда dig +short portal.example.org має повернути ваше посилання доступу або IP-адресу сервера.

Крок 2. Зіставте домен із застосунком

Docker
Kubernetes

Додайте зіставлення до файлу .env у каталозі розгортання. Кілька зіставлень розділяйте комами без пробілів:

.env

APP_CUSTOM_DOMAINS=portal.example.org=portal.app.teable.example.com

Застосуйте зміни:

./apply.sh server --with-app    # не вказуйте --with-app, якщо запускаєте лише середовище виконання
docker compose up -d

Сертифікати налаштовуються автоматично:

Якщо ваш власний сертифікат (TLS_CERT_FILE) уже охоплює цей домен, використовується він.
Інакше сертифікат Let’s Encrypt запитується й поновлюється автоматично. Для цього домен має вказувати на сервер, а порти 80 і 443 мають бути доступні з інтернету.

У внутрішній мережі без вхідного доступу з інтернету натомість додайте домен до сертифіката, який ви вказуєте в TLS_CERT_FILE.

Додайте зіставлення до Helm values:

values.yaml

appRuntime:
  customDomains:
    - host: portal.example.org
      target: portal.app.teable.example.com

Застосуйте зміни:

helm upgrade <release> <chart> -n <namespace> -f values.yaml

Сертифікати: за замовчуванням чарт запитує в cert-manager сертифікат Let’s Encrypt через HTTP-01; для цього домен має вказувати на публічну адресу вашого контролера Ingress. У приватній мережі створіть для домену TLS-секрет у просторі імен, куди встановлено чарт, і вкажіть його:

values.yaml

appRuntime:
  customDomains:
    - host: portal.example.org
      target: portal.app.teable.example.com
      tlsSecretName: portal-example-org-tls

Якщо TLS завершується на балансувальнику навантаження перед кластером, натомість додайте сертифікат домену на балансувальник.

Крок 3. Перевірте результат

Відкрийте https://portal.example.org. Застосунок завантажується, а в адресному рядку залишається portal.example.org. Перевірка з термінала:

curl -sI https://portal.example.org    # очікується 200 без переспрямування на посилання доступу

Початкове посилання доступу застосунку й надалі працює. Застосунки, що потребують входу, після входу повертають відвідувачів на цей домен; якщо на один застосунок вказує кілька доменів, відвідувачі повертаються на домен, вказаний першим.

Зміна або видалення домену

Щоб перенести домен на інший застосунок, зіставте його з посиланням доступу іншого застосунку й знову застосуйте зміни.
Після перейменування застосунку або зняття його з публікації одразу оновіть або видаліть його зіставлення: звільнене посилання доступу може зайняти інший застосунок.
Щоб видалити домен, видаліть його зіставлення, знову застосуйте зміни, а потім видаліть DNS-запис.

Усунення несправностей

Ознака	Імовірна причина
Помилка `app_runtime_host_not_bound`	Посилання доступу в зіставленні не збігається з поточним посиланням застосунку (наприклад, після перейменування) або застосунок не опубліковано.
Порожня сторінка або попередження про сертифікат	Домену немає в зіставленні або конфігурацію не застосовано; DNS ще не вказує на ваше розгортання; порт 80 заблоковано, тому Let’s Encrypt не може перевірити домен; або ваш власний сертифікат не містить цього домену.
Браузер не може знайти домен	DNS-запис відсутній або ще не поширився. Перевірте його командою `dig +short <domain>`.

Ліцензія для самостійного розгортання

Швидкий старт

Системне адміністрування

Налаштування

Відповідність вимогам і телеметрія

Обслуговування

Застаріле

Власні домени для опублікованих застосунків у самостійно розгорнутому Teable

Перейменування посилання доступу

Розміщення застосунку на окремому домені

Крок 1. Спрямуйте домен на своє розгортання

Крок 2. Зіставте домен із застосунком

Крок 3. Перевірте результат

Зміна або видалення домену

Усунення несправностей

​Перейменування посилання доступу

​Розміщення застосунку на окремому домені

​Крок 1. Спрямуйте домен на своє розгортання

​Крок 2. Зіставте домен із застосунком

​Крок 3. Перевірте результат

​Зміна або видалення домену

​Усунення несправностей

Перейменування посилання доступу

Розміщення застосунку на окремому домені

Крок 1. Спрямуйте домен на своє розгортання

Крок 2. Зіставте домен із застосунком

Крок 3. Перевірте результат

Зміна або видалення домену

Усунення несправностей