bedrud komut satırı arayüzü için tam referans.
Özet
# Alt komut stili
bedrud <komut> [bayraklar]
# Bayrak stili
bedrud --livekit --config <yol>
bedrud --run --config <yol>Komutlar
run / server
API, gömülü web önyüzü ve (yapılandırılmışsa) gömülü LiveKit ile Bedrud toplantı sunucusunu başlatır.
bedrud run [--config <yol>]
bedrud server [--config <yol>]| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--config | $CONFIG_PATH ortam değişkeni → "config.yaml" | Bedrud YAML yapılandırma dosyasının yolu |
Davranış:
- Yapılandırmayı belirtilen yoldan veya varsayılanlardan yükler
- Dahili mod için yapılandırılmışsa gömülü LiveKit’i başlatır
- SQLite/PostgreSQL veritabanını başlatır ve göçleri çalıştırır
- Tüm API yollarıyla Fiber HTTP sunucusu oluşturur
- Gömülü React önyüzünü sunar
- ACME (Let’s Encrypt), kendi imzalı TLS, manuel TLS veya düz HTTP destekler
- SIGTERM/SIGINT sinyalinde düzgün kapanma
Uygulama: server/internal/server/server.go
--livekit
Yalnızca gömülü LiveKit medya sunucusunu başlatır. İkili dosyayı Go embed’dan geçici bir dizine çıkarır.
bedrud --livekit --config <yol>| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--config | (gerekli) | LiveKit YAML yapılandırma dosyasının yolu |
Kullanan: bedrud install tarafından oluşturulan systemd livekit.service
Uygulama: server/internal/livekit/server.go
--run
Aynı --config bayrak davranışıyla bedrud run için takma ad. systemd bedrud.service tarafından kullanılır.
bedrud --run --config <yol>install
Bedrud’u bir Debian/Linux sistemine kurar. systemd servisleri, yapılandırma dosyaları, dizinler ve TLS sertifikaları oluşturur.
bedrud install [bayraklar]| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--tls | false | HTTPS’yi etkinleştir (--self-signed ile aynı) |
--self-signed | false | Kendi imzalı TLS sertifikası oluştur |
--no-tls | false | TLS’yi tamamen devre dışı bırak (düz HTTP). --tls ve --self-signed’i geçersiz kılar |
--ip | otomatik algılandı | Otomatik algılanan sunucu IP adresini geçersiz kıl |
--domain | "" | Let’s Encrypt veya kendi imzalı sertifika için alan adı |
--email | "" | Let’s Encrypt kaydı için e-posta |
--port | "443" (TLS) / "8090" (HTTP) | Dinleme bağlantı noktasını geçersiz kıl |
--cert | "" | Mevcut PEM sertifika dosyasının yolu |
--key | "" | Mevcut PEM özel anahtar dosyasının yolu |
--lk-port | "7880" | LiveKit API/WebSocket bağlantı noktasını geçersiz kıl |
--lk-tcp-port | "7881" | LiveKit RTC TCP bağlantı noktasını geçersiz kıl |
--lk-udp-port | "7882" | LiveKit RTC UDP bağlantı noktasını geçersiz kıl |
--fresh | false | Kurulumdan önce mevcut kurulumu kaldır |
--behind-proxy | false | Sunucu CDN/ters vekil arkasında (Cloudflare, nginx) |
--external-livekit | "" | Tamamen harici LiveKit sunucusunun URL’si (farklı makine) |
--livekit-domain | "" | Yerel LiveKit sunucusu için ayrı alan adı (CDN’yi atlar) |
Yaptığı işler:
--freshise önceki kurulumu durdurur ve kaldırır- IP, alan adı, e-posta, TLS modu için sorar (etkileşimli olmayan ve bayraklar sağlanmamışsa)
- Dizinleri oluşturur:
/etc/bedrud,/var/lib/bedrud,/var/lib/bedrud/certs,/var/log/bedrud - İkili dosyayı
/usr/local/bin/bedrudkonumuna kopyalar /etc/bedrud/config.yamlkonumunda Bedrud sunucu yapılandırması oluşturur/etc/bedrud/livekit.yamlkonumunda LiveKit medya sunucusu yapılandırması oluşturur/etc/bedrud/cert.pem+/etc/bedrud/key.pemkonumunda kendi imzalı sertifikalar oluşturur (TLS etkinse ve özel sertifikalar yoksa)- systemd
livekit.serviceoluşturur (harici LiveKit kullanılmıyorsa) - systemd
bedrud.serviceoluşturur systemctl daemon-reloadçalıştırır, her iki servisi de etkinleştirir ve başlatır- Erişim URL’lerini yazdırır
TLS seçenekleri:
--domain+--email→ ACME (Let’s Encrypt)--self-signedveya--tls→ kendi imzalı sertifika--cert+--key→ özel sertifikalar--no-tls→ yalnızca düz HTTP
LiveKit topolojisi:
- Varsayılan (gömülü): LiveKit yerel olarak çalışır, Bedrud üzerinden
/livekitadresine vekil yapılır --livekit-domain: LiveKit yerel olarak çalışır ama istemciler kendi alan adı üzerinden doğrudan bağlanır--external-livekit: Yerel LiveKit yok; uzak sunucuya bağlanır
Uygulama: server/internal/install/debian.go
İlgili belgeler: Kurulum Kılavuzu • Dağıtım Kılavuzu • Arka Uç Dağıtım Mantığı
uninstall
Bedrud’u sistemden kaldırır.
bedrud uninstallKaldırdıkları:
- systemd servislerini durdurur ve devre dışı bırakır:
bedrud,livekit - systemd birim dosyalarını
/etc/systemd/system/konumundan kaldırır - İkili dosyaları kaldırır:
/usr/local/bin/bedrud,/tmp/bedrud,/tmp/bedrud-livekit-server - Dizinleri kaldırır:
/etc/bedrud,/var/lib/bedrud,/var/log/bedrud
Uygulama: server/internal/install/debian.go
İlgili belgeler: Kurulum Kılavuzu - Kaldırma
user
Bedrud veritabanındaki kullanıcıları yönetir.
bedrud user <alt-komut> [--config <yol>] <bayraklar>| Genel Bayrak | Varsayılan | Açıklama |
|---|---|---|
--config | /etc/bedrud/config.yaml | Bedrud yapılandırma dosyasının yolu (veritabanını bulmak için) |
create
Yerel kimlik doğrulama ile yeni bir kullanıcı oluşturur (bcrypt ile hashlenmiş parola).
bedrud user create --email <e-posta> --password <parola> --name <ad>Gerekli bayraklar:
--email: Kullanıcı e-posta adresi--password: Kullanıcı parolası, depolanmadan önce bcrypt ile hashlenir--name: Kullanıcı görünen adı
Erişim seviyesi: user (süper yönetici değil). Yönetici hakları vermek için promote kullanın.
delete
Bir kullanıcıyı e-posta adresine göre siler.
bedrud user delete --email <e-posta>promote
Bir kullanıcıya superadmin erişimi verir.
bedrud user promote --email <e-posta>demote
Bir kullanıcıdan superadmin erişimini kaldırır (user seviyesine döner).
bedrud user demote --email <e-posta>Uygulama: server/internal/usercli/usercli.go
help
Tüm komutlar ve bayraklarla kullanım mesajını gösterir.
bedrud helpHiçbir argüman sağlanmadığında da tetiklenir. printUsage() çıktısını görüntüler.
Örnekler
Temel geliştirme sunucusu başlatma
# Geçerli dizindeki varsayılan config.yaml ile çalıştır
bedrud run
# Özel yapılandırma ile çalıştır
bedrud run --config /path/to/config.yaml
# Ortam değişkeni ile (geri dönüş)
export CONFIG_PATH=/etc/bedrud/config.yaml
bedrud runEtkileşimli kurulum (girişler için sorar)
bedrud installLet’s Encrypt ile etkileşimli olmayan kurulum
bedrud install --domain example.com --email admin@example.comÖzel bağlantı noktalarıyla kendi imzalı TLS
bedrud install --self-signed --port 8443 --lk-port 7880 --lk-tcp-port 7881 --lk-udp-port 7882CDN arkasında ayrı LiveKit alan adı ile
bedrud install --domain bedrud.example.com --email admin@example.com --livekit-domain lk.example.com --behind-proxyTemiz yeniden kurulum
bedrud install --fresh --domain example.com --email admin@example.comKullanıcı yönetimi
# İlk yönetici kullanıcısını oluştur
bedrud user create --email admin@example.com --password secret123 --name "Admin User"
# Süper yönetici erişimi ver
bedrud user promote --email admin@example.com
# Normal kullanıcı oluştur
bedrud user create --email user@example.com --password pass456 --name "Regular User"
# Bir kullanıcıyı kaldır
bedrud user delete --email user@example.com
# Yönetici erişimini kaldır
bedrud user demote --email admin@example.comİlgili Belgeler
- Kurulum Kılavuzu - Ayrıntılı
bedrud installkılavuzu, TLS topolojileri, kurulum sonrası adımlar - Yapılandırma Referansı - Sunucu ve LiveKit yapılandırma dosyası yapısı
- Arka Uç Dağıtım Mantığı -
installveuninstalldahili olarak nasıl çalışır - Dağıtım Kılavuzu - systemd servisleri dahil tam dağıtım seçenekleri