Files
twenty/packages/twenty-docs/l/pl/developers/self-hosting/troubleshooting.mdx
T
8cadd00d34 i18n - translations (#15799)
Created by Github action

---------

Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
Co-authored-by: github-actions <github-actions@twenty.com>
2025-11-13 16:34:00 +01:00

226 lines
9.5 KiB
Plaintext

---
title: Rozwiązywanie problemów
image: /images/user-guide/what-is-twenty/20.png
---
<Frame>
<img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
</Frame>
## Rozwiązywanie problemów
Jeśli wystąpi jakikolwiek problem podczas konfiguracji środowiska do rozwoju, aktualizacji instancji lub samodzielnego hostingu, oto rozwiązania typowych problemów.
### Hosting własny
#### Pierwsza instalacja powoduje `weryfikacja hasła dla użytkownika "postgres" nie powiodła się`
🚨 **WAŻNE: To rozwiązanie dotyczy tylko nowych instalacji** 🚨
Jeśli masz istniejącą instancję Twenty z danymi produkcyjnymi, **NIE** postępuj zgodnie z tymi krokami, ponieważ spowodują one trwałe usunięcie bazy danych!
Podczas pierwszej instalacji Twenty, możesz chcieć zmienić domyślne hasło do bazy danych.
Hasło ustawione podczas pierwszej instalacji jest na stałe zapisywane w woluminie bazy danych. Jeśli później spróbujesz zmienić to hasło w swojej konfiguracji bez usuwania starego woluminu, pojawią się błędy uwierzytelniania, ponieważ baza danych wciąż używa oryginalnego hasła.
⚠️ OSTRZEŻENIE: Następujące kroki TRWALE USUNĄ wszystkie dane bazy danych! ⚠️
Przejdź dalej tylko wtedy, gdy jest to nowa instalacja bez ważnych danych.
Aby zaktualizować `PG_DATABASE_PASSWORD` musisz:
```sh
# Update the PG_DATABASE_PASSWORD in .env
docker compose down --volumes
docker compose up -d
```
#### Znaleziono złamanie wiersza CR [Windows]
Jest to spowodowane znakami złamania wiersza w systemie Windows i konfiguracją gita. Spróbuj uruchomić:
```
git config --global core.autocrlf false
```
Następnie usuń repozytorium i sklonuj je ponownie.
#### Missing metadata schema
Podczas instalacji Twenty musisz zaopatrzyć swoją bazę danych postgres w odpowiednie schematy, rozszerzenia i użytkowników.
Jeśli pomyślnie uruchomiłeś tę konfigurację, powinieneś mieć schematy `default` i `metadata` w swojej bazie danych.
Jeśli nie, upewnij się, że nie masz więcej niż jednej instancji postgres działającej na komputerze.
#### Nie można znaleźć modułu 'twenty-emails' lub jego odpowiednich deklaracji typów.
Musisz zbudować pakiet `twenty-emails` przed uruchomieniem inicjalizacji bazy danych za pomocą `npx nx run twenty-emails:build`
#### Brak pakietu twenty-x
Upewnij się, że uruchomiony jest yarn w katalogu głównym, a następnie uruchom `npx nx server:dev twenty-server`. Jeśli to nadal nie działa, spróbuj ręcznie zbudować brakujący pakiet.
#### Lint on Save nie działa
To powinno działać od razu po zainstalowaniu rozszerzenia eslint. Jeśli to nie działa, spróbuj dodać to do ustawień vscode (w zasięgu kontenera deweloperskiego):
```
"editor.codeActionsOnSave": {
"source.fixAll.eslint": "explicit"
}
```
#### While running `npx nx start` or `npx nx start twenty-front`, Out of memory error is thrown
W `packages/twenty-front/.env` skomentuj `VITE_DISABLE_TYPESCRIPT_CHECKER=true` i `VITE_DISABLE_ESLINT_CHECKER=true`, aby wyłączyć sprawdzanie w tle, co zmniejsza ilość potrzebnego RAM-u.
**If it does not work:**
Run only the services you need, instead of `npx nx start`. Na przykład, jeśli pracujesz nad serwerem, uruchom tylko `npx nx worker twenty-server`
**Jeśli to nie działa:**
Jeśli próbowałeś uruchomić tylko `npx nx run twenty-server:start` na WSL i kończy się to błędem pamięci przedstawionym poniżej:
`FATAL ERROR: Nieskuteczne mark-compact'y w pobliżu limitu sterty Alokacja nie powiodła się - brak pamięci na stercie JavaScriptu`
Obejściem jest wykonanie poniższego polecenia w terminalu lub dodanie go do profilu .bashrc, aby automatycznie ustawić:
`export NODE_OPTIONS="--max-old-space-size=8192"`
Flaga --max-old-space-size=8192 ustawia górny limit 8 GB dla sterty Node.js; wykorzystanie skaluje się z zapotrzebowaniem aplikacji.
Odwołanie: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048
**Jeśli to nie działa:**
Zbadaj, które procesy zużywają większość pamięci RAM twojego komputera. W Twenty zauważyliśmy, że niektóre rozszerzenia VScode zużywają dużo RAM, więc tymczasowo je wyłączamy.
**Jeśli to nie działa:**
Restartowanie komputera pomaga oczyścić „duchy” procesów.
#### Podczas uruchamiania `npx nx start` występują dziwne [0] i [1] w logach
To oczekiwane, ponieważ polecenie `npx nx start` uruchamia więcej poleceń w tle.
#### Nie są wysyłane żadne emaile
Najczęściej to z powodu braku uruchomienia `worker` w tle. Spróbuj uruchomić
```
npx nx worker twenty-server
```
#### Nie mogę połączyć mojego konta Microsoft 365
Najczęściej to z powodu nieuaktywnienia licencji Microsoft 365 dla twojego konta przez administratora. Sprawdź [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home).
Jeśli masz kod błędu `AADSTS50020`, prawdopodobnie używasz osobistego konta Microsoft. To jeszcze nie jest obsługiwane. Więcej informacji [tutaj](https://learn.microsoft.com/fr-fr/troubleshoot/entra/entra-id/app-integration/error-code-aadsts50020-user-account-identity-provider-does-not-exist)
#### Podczas uruchamiania `yarn` pojawiają się ostrzeżenia w konsoli
Ostrzeżenia informują o pobieraniu dodatkowych zależności, które nie są jawnie wymienione w `package.json`, więc dopóki nie pojawi się poważny błąd, wszystko powinno działać zgodnie z oczekiwaniami.
#### Gdy użytkownik uzyskuje dostęp do strony logowania, w logach pojawia się błąd dotyczący nieautoryzowanego użytkownika próbującego uzyskać dostęp do przestrzeni roboczej
To oczekiwane, ponieważ użytkownik jest nieautoryzowany po wylogowaniu, ponieważ jego tożsamość nie została zweryfikowana.
#### Jak sprawdzić, czy `worker` działa?
- Przejdź do [webhook-test.com](https://webhook-test.com/) i skopiuj **Your Unique Webhook URL**.
<div style={{textAlign: 'center'}}>
<img src="/images/docs/developers/self-hosting/webhook-test.jpg" alt="Webhook test" />
</div>
- Otwórz aplikację Twenty, przejdź do `/settings`, i włącz przełącznik **Zaawansowane** w dolnym lewym rogu ekranu.
- Create a new webhook.
- Wklej **Your Unique Webhook URL** w polu **Endpoint Url** w Twenty. Ustaw **Filtry** na `Companies` i `Created`.
<div style={{textAlign: 'center'}}>
<img src="/images/docs/developers/self-hosting/webhook-settings.jpg" alt="Webhook settings" />
</div>
- Przejdź do `/objects/companies`, i utwórz nowy rekord firmy.
- Return to [webhook-test.com](https://webhook-test.com/) and check if a new **POST request** has been received.
<div style={{textAlign: 'center'}}>
<img src="/images/docs/developers/self-hosting/webhook-test-result.jpg" alt="Webhook test result" />
</div>
- Jeśli otrzymano **POST request**, to twój `worker` działa prawidłowo. W przeciwnym razie, musisz rozwiązać problemy swojego `worker`.
#### Nie udało się uruchomić frontendu i pojawia się błąd TS5042: Opcja 'project' nie może być mieszana z plikami źródłowymi w linii poleceń
Skomentuj wtyczkę checker w `packages/twenty-ui/vite-config.ts` jak w poniższym przykładzie
```
plugins: [
react({ jsxImportSource: '@emotion/react' }),
tsconfigPaths(),
svgr(),
dts(dtsConfig),
// checker(checkersConfig),
wyw({
include: [
'**/OverflowingTextWithTooltip.tsx',
'**/Chip.tsx',
'**/Tag.tsx',
'**/Avatar.tsx',
'**/AvatarChip.tsx',
],
babelOptions: {
presets: ['@babel/preset-typescript', '@babel/preset-react'],
},
}),
],
```
#### Panel administracyjny niedostępny
Uruchom `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` w kontenerze bazy danych, aby uzyskać dostęp do panelu administracyjnego.
### 1-click Docker compose
#### Nie można się zalogować
Jeśli nie możesz się zalogować po konfiguracji:
1. Uruchom następujące polecenia:
```bash
docker exec -it twenty-server-1 yarn
docker exec -it twenty-server-1 npx nx database:reset --configuration=no-seed
```
2. Uruchom ponownie kontenery Dockera:
```bash
docker compose down
docker compose up -d
```
Zwróć uwagę, że polecenie database:reset całkowicie wyczyści bazę danych i utworzy ją od nowa.
#### Problemy z połączeniem za odwrotnym proxy
Jeśli uruchamiasz Twenty za odwrotnym proxy i występują problemy z połączeniem:
1. **Zweryfikuj SERVER_URL:**
Upewnij się, że `SERVER_URL` w twoim pliku `.env` odpowiada twojemu zewnętrznemu adresowi URL dostępu, w tym `https`, jeśli SSL jest włączony.
2. **Sprawdź ustawienia odwrotnego proxy:**
- Upewnij się, że twoje odwrotne proxy prawidłowo przekazuje żądania do serwera Twenty.
- Upewnij się, że nagłówki takie jak `X-Forwarded-For` i `X-Forwarded-Proto` są prawidłowo ustawione.
3. **Uruchom ponownie usługi:**
Po dokonaniu zmian uruchom ponownie zarówno odwrotne proxy, jak i kontenery Twenty.
#### Błąd podczas przesyłania obrazu - odmowa dostępu
Zmiana właściciela folderu danych na hoście z root na innego użytkownika i grupę rozwiązuje ten problem.
## Uzyskiwanie pomocy
Jeśli napotkasz problemy, które nie są objęte tym przewodnikiem:
- Sprawdź Logi:
Sprawdź logi kontenera pod kątem komunikatów o błędach:
```bash
docker compose logs
```
- Wsparcie społeczności:
Skontaktuj się z [społecznością Twenty](https://github.com/twentyhq/twenty/issues) lub [kanałami wsparcia](https://discord.gg/cx5n4Jzs57) po pomoc.