Αναφορά διαμόρφωσης
Πλήρης αναφορά για όλες τις μεταβλητές περιβάλλοντος που χρησιμοποιούνται για τη διαμόρφωση αυτο-φιλοξενούμενης ανάπτυξης rtCloud.
Όλη η διαμόρφωση γίνεται μέσω μεταβλητών περιβάλλοντος στο αρχείο .env στο ριζικό κατάλογο της ανάπτυξής σας. Το Docker Compose διαβάζει αυτό το αρχείο αυτόματα — δεν απαιτείται σημαία --env-file.
Οι μεταβλητές που επισημαίνονται ως απαιτούμενες πρέπει να οριστούν πριν εκκινήσετε τα κοντέινερ. Όλες οι άλλες έχουν προεπιλογές και είναι προαιρετικές.
Έργο
Αυτές οι μεταβλητές ορίζουν την ταυτότητα και το σημείο πρόσβασης της εγκατάστασης rtCloud.
| Μεταβλητή | Προεπιλογή | Απαιτείται | Περιγραφή |
|---|---|---|---|
PROJECT_ID | — | Ναι | Μοναδικό αναγνωριστικό για αυτή την ανάπτυξη. Χωρίς κενά ή ειδικούς χαρακτήρες. |
PROJECT_URL | — | Ναι | Όνομα τομέα ή διεύθυνση IP όπου οι χρήστες έχουν πρόσβαση στην εφαρμογή (π.χ. rtcloud.example.com ή 192.168.1.100). |
PROJECT_TYPE | rtsurvey | Όχι | Παραλλαγή πλατφόρμας. Επιλογές: rtwork, rtsurvey, rthome. |
PROJECT_PORT | 80 | Όχι | Θύρα που ακούει η εφαρμογή εντός του κοντέινερ. Μην αλλάζετε εκτός αν γνωρίζετε τι κάνετε. |
HTTP_PROTOCOL | https | Όχι | Πρωτόκολλο για κατασκευή εσωτερικών URL. Ορίστε σε http εάν δεν χρησιμοποιείτε SSL. |
Βάση δεδομένων
Διαπιστευτήρια σύνδεσης MySQL. Η βάση δεδομένων διαχειρίζεται αυτόματα από το κοντέινερ MySQL — χρειάζεται μόνο να ορίσετε ισχυρούς κωδικούς.
| Μεταβλητή | Προεπιλογή | Απαιτείται | Περιγραφή |
|---|---|---|---|
MYSQL_DATABASE | smartsurvey | Όχι | Όνομα βάσης δεδομένων εφαρμογής. |
MYSQL_USER | smartsurvey | Όχι | Χρήστης MySQL για την εφαρμογή. |
MYSQL_PASSWORD | — | Ναι | Κωδικός για MYSQL_USER. Χρησιμοποιήστε ισχυρή, μοναδική τιμή. |
MYSQL_ROOT_PASSWORD | — | Ναι | Κωδικός root MySQL. Απαιτείται για αρχικοποίηση βάσης δεδομένων και λειτουργίες διαχείρισης. |
MYSQL_HOST | mysql | Όχι | Κεντρικός υπολογιστής MySQL. Χρησιμοποιήστε την προεπιλογή εκτός αν συνδέεστε σε εξωτερική βάση δεδομένων. |
MYSQL_PORT | 3306 | Όχι | Θύρα MySQL. |
Λογαριασμός διαχειριστή
Ο λογαριασμός διαχειριστή δημιουργείται αυτόματα κατά την πρώτη εκκίνηση σε νέα βάση δεδομένων.
| Μεταβλητή | Προεπιλογή | Απαιτείται | Περιγραφή |
|---|---|---|---|
ADMIN_PASSWORD | admin | Ναι | Κωδικός για τον ενσωματωμένο χρήστη admin. Ορίστε πριν από την πρώτη εκκίνηση. Δεν έχει εφέ εάν η βάση δεδομένων υπάρχει ήδη. |
Μετά την πρώτη σύνδεση, αλλάξτε τον κωδικό διαχειριστή από τη σελίδα Ρυθμίσεις λογαριασμού στη διεπαφή χρήστη web.
Θύρες
Ελέγξτε ποιες θύρες κεντρικού υπολογιστή δεσμεύει η εφαρμογή.
| Μεταβλητή | Προεπιλογή | Περιγραφή |
|---|---|---|
APP_PORT | 8080 | Θύρα κεντρικού υπολογιστή για την κύρια διεπαφή χρήστη web. |
SHINY_PORT | 3838 | Θύρα κεντρικού υπολογιστή για τον διακομιστή αναλύσεων Shiny. |
Χρόνος εκτέλεσης
| Μεταβλητή | Προεπιλογή | Περιγραφή |
|---|---|---|
RUN_ENV | prod | Περιβάλλον εκτέλεσης. Χρησιμοποιήστε prod για παραγωγή, dev για τοπική ανάπτυξη. |
RUN_MODE | admin | Ρόλος κοντέινερ. Το admin εκτελεί την πλήρη στοίβα (web + ουρά + cron). Το worker εκτελεί μόνο επεξεργασία παρασκηνίου. |
TZ | Asia/Ho_Chi_Minh | Ζώνη ώρας διακομιστή. Επηρεάζει χρονοσφραγίδες καταγραφής, χρονοδιαγράμματα cron και εμφάνιση ημερομηνίας. |
LOG_LEVEL | info | Επίπεδο λεπτομέρειας καταγραφής εφαρμογής. Επιλογές: debug, info, warning, error. |
COMPOSE_PROJECT_NAME | rtcloud | Πρόθεμα σε όλα τα ονόματα κοντέινερ και τόμων Docker. |
RESTART_POLICY | unless-stopped | Συμπεριφορά επανεκκίνησης κοντέινερ Docker. |
RTCLOUD_IMAGE | rtawebteam/rta-smartsurvey:survey-dockerize | Εικόνα Docker για χρήση. |
REQUIRE_LICENSE | false | Ενεργοποίηση επικύρωσης κλειδιού άδειας κατά την εκκίνηση. |
Ασφάλεια
| Μεταβλητή | Προεπιλογή | Περιγραφή |
|---|---|---|
CSRF_VALIDATION_ENABLED | true | Ενεργοποίηση επικύρωσης διακριτικού CSRF. Διατηρήστε σε true στην παραγωγή. |
GII_ENABLED | false | Ενεργοποίηση εργαλείου γεννήτριας κώδικα Yii. Ποτέ μην ενεργοποιείτε στην παραγωγή. |
SSO — Ενσωματωμένο Keycloak
Ενεργοποιήστε το ομαδοποιημένο κοντέινερ Keycloak για πλήρες εταιρικό SSO. Απαιτεί τομέα με HTTPS.
| Μεταβλητή | Προεπιλογή | Περιγραφή |
|---|---|---|
EMBED_KEYCLOAK | false | Ορίστε σε true για εκκίνηση ενσωματωμένου κοντέινερ Keycloak. |
KEYCLOAK_URL | — | Πλήρες URL του διακομιστή Keycloak (π.χ. https://rtcloud.example.com/auth). |
KEYCLOAK_REALM | — | Όνομα realm Keycloak (π.χ. rtsurvey). |
KEYCLOAK_CLIENT_ID | — | ID πελάτη Keycloak για την εφαρμογή rtCloud. |
KEYCLOAK_CLIENT_SECRET | — | Μυστικό πελάτη Keycloak. |
KEYCLOAK_ADMIN_USER | admin | Όνομα χρήστη διαχειριστή Keycloak. |
KEYCLOAK_ADMIN_PASSWORD | — | Κωδικός διαχειριστή Keycloak. |
KEYCLOAK_DB | keycloak | Όνομα βάσης δεδομένων για Keycloak. |
KEYCLOAK_DB_USER | keycloak | Χρήστης βάσης δεδομένων για Keycloak. |
KEYCLOAK_DB_PASSWORD | — | Κωδικός βάσης δεδομένων για τον χρήστη Keycloak. |
KC_HOSTNAME | — | URL εμπρόσθιου άκρου Keycloak. |
KC_HOSTNAME_STRICT | false | Επιβολή αυστηρής αντιστοίχισης ονόματος κεντρικού υπολογιστή. |
Ανατρέξτε στο Ταυτοποίηση SSO για τον πλήρη οδηγό ρύθμισης.
SSO — Εξωτερικός πάροχος OIDC
Σύνδεση με υπάρχοντα πάροχο ταυτοτήτων συμβατό με OIDC (Supabase, Auth0, Authentik, Okta κ.λπ.).
| Μεταβλητή | Προεπιλογή | Περιγραφή |
|---|---|---|
OIDC_ISSUER_URL | — | URL ανακάλυψης εκδότη OIDC. |
OIDC_CLIENT_ID | — | ID πελάτη καταχωρημένου στον πάροχο ταυτοτήτων. |
OIDC_CLIENT_SECRET | — | Μυστικό πελάτη από τον πάροχο ταυτοτήτων. |
OIDC_SCOPE | openid profile email | Διαχωρισμένη με κενά λίστα εύρους OIDC για αίτηση. |
OIDC_REDIRECT_URI | — | URL επιστροφής για την εφαρμογή web. |
OIDC_MOBILE_CLIENT_ID | — | Ξεχωριστό ID πελάτη για την εφαρμογή κινητού rtSurvey. |
OIDC_MOBILE_REDIRECT_URI | — | URI επιστροφής εφαρμογής κινητού. |
OPEN_REGISTRATION | false | Αυτόματη δημιουργία λογαριασμών rtCloud για χρήστες που ταυτοποιούνται μέσω OIDC για πρώτη φορά. |
SSO — Azure Active Directory
| Μεταβλητή | Περιγραφή |
|---|---|
AZURE_CLIENT_ID | ID εφαρμογής Azure AD (πελάτης). |
AZURE_TENANT_ID | ID καταλόγου Azure AD (μισθωτής). |
Προαιρετικές ενσωματώσεις
Stata
| Μεταβλητή | Προεπιλογή | Περιγραφή |
|---|---|---|
STATA_ENABLED | false | Ενεργοποίηση ενσωμάτωσης Stata για ανάλυση δεδομένων. |
STATA_BIN_PATH | /usr/bin/stata | Απόλυτη διαδρομή στο εκτελέσιμο Stata εντός του κοντέινερ. |
Elasticsearch
| Μεταβλητή | Περιγραφή |
|---|---|
ES_HOST | Κεντρικός υπολογιστής Elasticsearch. |
ES_PORT | Θύρα Elasticsearch. |
Matomo Analytics
| Μεταβλητή | Περιγραφή |
|---|---|
PIWIK_URL | URL διακομιστή Matomo (Piwik). |
PIWIK_ID | ID ιστοτόπου Matomo. |
PIWIK_SECRET | Διακριτικό ταυτοποίησης Matomo. |
Τόμοι δεδομένων
Όλα τα δεδομένα εφαρμογής αποθηκεύονται σε ονομαστικούς τόμους Docker. Οι τόμοι δημιουργούνται αυτόματα κατά την πρώτη εκκίνηση και παραμένουν σε επανεκκινήσεις και ενημερώσεις κοντέινερ.
| Τόμος | Σημείο προσάρτησης | Περιεχόμενα |
|---|---|---|
rtcloud_mysql_data | /var/lib/mysql | Αρχεία βάσης δεδομένων MySQL |
rtcloud_uploads | …/uploads | Αρχεία που μεταφορτώθηκαν από ερωτώμενους |
rtcloud_audios | …/audios | Ηχογραφήσεις |
rtcloud_downloads | …/downloads | Δημιουργημένα αρχεία εξαγωγής |
rtcloud_gallery | …/gallery | Εικόνες γκαλερί |
rtcloud_shiny_data | /srv/shiny-server/smartsurvey | Σενάρια R διακομιστή Shiny |
rtcloud_shiny_logs | /var/log/shiny-server | Αρχεία καταγραφής διακομιστή Shiny |
Παραθέστε όλους τους τόμους για την ανάπτυξή σας:
docker volume ls | grep rtcloud