Zum Hauptinhalt springen

Installation ohne Docker

Die Installation von Tianji mit Docker ist der beste Weg, da Sie sich nicht um Umweltprobleme kümmern müssen.

Falls Ihr Server jedoch keine Docker-Unterstützung bietet, können Sie es manuell installieren.

Anforderungen​

Sie benötigen:

  • Node.js 18.12+ / 20.4+
  • pnpm 9.x (9.7.1 wird empfohlen)
  • Git
  • Postgresql
  • pm2 - Um Tianji im Hintergrund auszuführen
  • apprise - optional, falls Sie Benachrichtigungen benötigen

Code klonen und bauen​

git clone https://github.com/msgbyte/tianji.git
cd tianji
pnpm install

pnpm build

Umgebungsdatei vorbereiten​

Erstellen Sie eine .env Datei im Verzeichnis src/server

DATABASE_URL="postgresql://user:[email protected]:5432/tianji?schema=public"
JWT_SECRET="ersetzen-sie-mich-durch-einen-zufälligen-string"

Stellen Sie sicher, dass Ihre Datenbank-URL korrekt ist und denken Sie daran, die Datenbank zuvor zu erstellen.

Weitere Umgebungen finden Sie in diesem Dokument environment.

Wenn möglich, stellen Sie sicher, dass Ihre Zeichencodierung auf en_US.utf8 eingestellt ist, zum Beispiel: createdb -E UTF8 -l en_US.utf8 tianji

Server ausführen​

npm install pm2 -g && pm2 install pm2-logrotate

# Datenbankmigration initialisieren
cd src/server
pnpm db:migrate:apply

# Server starten
pm2 start ./dist/src/server/main.js --name tianji

Standardmäßig wird Tianji unter http://localhost:12345 ausgeführt.

Code auf neue Version aktualisieren​

# Neue Versions-/Tags übernehmen
cd tianji
git fetch --tags
git checkout -q <version>

# Abhängigkeiten aktualisieren
pnpm install

# Projekt bauen
pnpm build

# Datenbankmigrationen durchführen
cd src/server
pnpm db:migrate:apply

# Server neu starten
pm2 restart tianji

Häufig gestellte Fragen

Installation von isolated-vm fehlgeschlagen​

Wenn Sie Python 3.12 verwenden, wird möglicherweise folgender Fehler angezeigt:

ModuleNotFoundError: No module named 'distutils'

Dies liegt daran, dass Python 3.12 distutils als integriertes Modul entfernt hat. Es gibt jedoch eine gute Lösung dafür.

Sie können Ihre Python-Version von 3.12 auf 3.9 ändern, um das Problem zu beheben.

Wie man es mit Brew-verwaltetem Python löst​

brew install [email protected]
rm /opt/homebrew/bin/python3
ln -sf /opt/homebrew/bin/python3 /opt/homebrew/bin/python3.9

Anschließend können Sie die Version mit python3 --version überprüfen.