Created by Github action --------- Co-authored-by: Crowdin Bot <support+bot@crowdin.com> Co-authored-by: github-actions <github-actions@twenty.com>
226 lines
9.5 KiB
Plaintext
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. |