Kendi sunucunuzda kurmak

Herkese açık IP'si olan bir Linux sunucu (bu rehberde Ubuntu 22.04 ya da üstü). 80 ve 443 portları internetten erişilebilir olmalıdır: Let's Encrypt her sertifikayı bu portlar üzerinden doğrular. İçeri başka hiçbir portun açık olması gerekmez; Connector daha sonra yalnızca dışarı bağlanır.

apt update && apt -y upgrade
ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw --force enable

Compose v2 ile Docker Engine; eski docker-compose ikilisi değil, docker compose alt komutu.

curl -fsSL https://get.docker.com | sh
docker version
docker compose version

Her şeyin altında yaşayacağı alt alan adını seçin, örneğin access.sirketiniz.com, ve sunucunun herkese açık IP'sine üç A kaydı oluşturun. Üçüncüsü bir joker (wildcard) kayıttır: yayımlayacağınız her tedarikçi uygulamasını kapsayan tek kayıt; böylece uygulama başına DNS'e bir daha dokunulmaz.

Devam etmeden önce kayıtların çözülmesini bekleyin: dig +short manager.access.sirketiniz.com ve dig +short herhangi.access.sirketiniz.com ikisi de sunucu IP'sini yazmalı; ikincisi joker kaydın çalıştığını gösterir.

Depoyu sunucuda klonlayın ve deploy dizinine girin. En hızlı yol kurulum betiğidir: verdiğiniz alan adından çerez alanını, genel adresi ve passkey relying-party kimliğini türetir, her gizli anahtarı bir kez üretir, yayımlanmış imajları çeker ve yığını başlatır. Tekrar çalıştırmak güvenlidir.

git clone https://github.com/captivo-io/captivo-access.git
cd captivo-access/deploy
./setup.sh access.example.com

Dosyayı elle doldurmayı tercih ederseniz .env.prod.example dosyasını .env olarak kopyalayın ve her gizli anahtarı openssl rand -hex 32 ile üretin. Önemli değişkenler:

Dört yetenek anahtarı RECORDING_ENABLED, NATIVE_GATEWAY, VAULT_ENABLED ve ISOLATED_ENABLED varsayılan olarak açıktır; yorum satırı olarak bırakın, yalnızca kapatmak istediğinizi 0 yapın. İşletme ayarlarının çoğu (saklama süreleri, oturum sınırları, izin listesi, webhook) daha sonra Infrastructure → Policy altından yönetilir; konsolda girilen değer ortam değişkenine her zaman üstün gelir.

Kurulum betiğini kullandıysanız bu adım zaten gerçekleşti. Aksi halde yığını başlatın ve Caddy'nin manager ve connect adresleri için ilk iki sertifikayı almasını izleyin; 80 ve 443 portlarının açık olması bunun içindi.

docker compose -f docker-compose.prod.yml up -d
docker compose -f docker-compose.prod.yml ps
docker compose -f docker-compose.prod.yml logs -f caddy

Veritabanı geçişini elle çalıştırmazsınız. access-migrate servisi şemayı her up -d komutunda uygular, değişiklik yoksa hiçbir şey yapmaz ve veri silebilecek hiçbir değişikliği kabul etmez. Manager başlamazsa önce docker compose -f docker-compose.prod.yml logs access-migrate çıktısını okuyun.

Zamanlanmış işler de otomatiktir: access-cron konteyneri kaynak erişilebilirliğini beş dakikada bir kontrol eder; denetim kaydı saklama, kayıt saklama ve denetim zinciri mühürleme işlerini günde bir çalıştırır. Sunucuda crontab gerekmez.

https://manager.access.sirketiniz.com/setup adresini açın ve ilk hesabı bir passkey ile kaydedin: Touch ID, Windows Hello ya da bir güvenlik anahtarı. Bu hesap Admin olur. Varsayılan ya da hazır bir hesap yoktur, parola da yoktur.

Konsolda Infrastructure → Custom domain sayfasını açın. Alan adınız için tam joker kaydı ve sunucunuzun IP'sini, bir Verify DNS düğmesiyle birlikte gösterir. Yeşil sonuç, joker kaydın canlı olduğu ve yayımlayacağınız her uygulamanın ilk ziyaretinde HTTPS alacağı anlamına gelir. Kırmızı, 3. adımdaki *.access kaydının eksik olduğu ya da henüz yayılmadığı anlamına gelir.

Buradan sonrası Cloud ile aynıdır: ağınızın içine bir Connector kurun, kaynakları tanımlayın, kişileri davet edin. Bir uygulama adresi sonradan sertifika hatası ya da 502 veriyorsa Uygulama açılmıyor rehberiyle başlayın.