Question 1

Caddy 뒤의 셀프 호스팅 Colanode에서 이모지/아이콘 선택기가 비어 있는 문제를 해결하려면 어떻게 해야 하나요?

Accepted Answer

빈 피커는 브라우저가 Caddy의 내부 SSL 인증서를 거부하여 서비스 워커가 등록되지 않기 때문에 발생합니다. 콘솔에는 일반적으로 다음과 같은 메시지가 표시됩니다: `Failed to register a ServiceWorker ... /service.js: An SSL certificate error occurred`.

클라이언트 머신에서 Caddy의 루트 CA를 신뢰하도록 설정하여 문제를 해결할 수 있습니다:

1. 컨테이너에서 Caddy의 로컬 루트 인증서를 복사합니다:
```bash
docker cp <caddy-container>:/data/caddy/pki/authorities/local/root.crt caddy-root.crt
```
2. 시스템에서 해당 인증서를 신뢰하도록 설정합니다:
- Debian/Ubuntu:
```bash
sudo cp caddy-root.crt /usr/local/share/ca-certificates/caddy-root.crt
sudo update-ca-certificates
```
- Windows: 인증서를 **Trusted Root Certification Authorities**로 가져옵니다.
- macOS: Keychain Access에 가져온 후 **Always Trust**로 설정합니다.
- Firefox: 시스템 저장소를 사용하지 않는 경우 **Settings > Privacy & Security > Certificates**에서 가져옵니다.
3. 브라우저를 완전히 다시 시작하고 Colanode를 새로 고칩니다.

그러면 이모지/아이콘 피커가 로드되고 서비스 워커 SSL 오류가 사라집니다. 또는 도메인에 Let's Encrypt와 같이 공개적으로 신뢰되는 인증서를 사용하세요. `OPFS sqlite3_vfs`/COOP/COEP 경고는 이 문제와 관련이 없습니다.

Question 2

Obsidian에서 붙여넣은 Markdown이 Colanode에서 #나 ``` 같은 원시 문자로 표시되는 이유는 무엇인가요?

Accepted Answer

이는 Colanode 편집기의 버그였습니다. 붙여넣은 Markdown이 서식이 적용된 블록으로 파싱되지 않고 코드 블록으로 처리되었습니다. Colanode v0.4.0에서 수정되었습니다. 최신 릴리스로 업그레이드한 후 Markdown 콘텐츠를 다시 붙여넣으세요. 업그레이드할 수 없는 경우, Markdown 구문 뒤의 공백을 수동으로 다시 입력하여(예: `##` 뒤의 공백을 삭제한 후 다시 추가) 서식이 적용되도록 하세요.

Question 3

npm install을 여러 번 실행한 후 발생하는 Colanode 클라이언트 빌드 오류 TS2305: '@tiptap/pm/model' has no exported member 'Node'를 수정하는 방법은?

Accepted Answer

이 문제는 반복된 `npm install` 실행으로 인해 필수 전이(transitive) TipTap/ProseMirror 패키지가 제거(prune)되고 `node_modules`가 `package-lock.json`과 동기화되지 않은 상태가 될 때 발생합니다. 깨끗한 상태에서 한 번의 설치로 복구하세요. 리포지토리 루트에서 설치된 의존성과 모든 워크스페이스 수준의 `node_modules` 디렉터리를 삭제한 후 한 번만 설치하세요:

Windows PowerShell:
```powershell
Remove-Item -Recurse -Force node_modules, package-lock.json -ErrorAction SilentlyContinue
Get-ChildItem packages -Directory | ForEach-Object {
  Remove-Item -Recurse -Force (Join-Path $_.FullName 'node_modules') -ErrorAction SilentlyContinue
}
npm install
```

macOS/Linux:
```bash
rm -rf node_modules package-lock.json packages/*/node_modules
npm install
```

그런 다음 `npm install`을 다시 실행하지 않고 즉시 빌드하세요:
```bash
npm run build -w @colanode/core && \
npm run build -w @colanode/crdt && \
npm run build -w @colanode/client && \
npm run build -w @colanode/ui && \
npm run build -w @colanode/web && \
npm prune --production
```

Docker 또는 반복 가능한 CI/self-host 빌드의 경우, 검증된 lockfile로부터 깨끗한 설치를 수행하는 것이 좋습니다:
```bash
npm ci
```
`npm ci`는 기존 `node_modules`를 삭제하고 `package-lock.json`에 기록된 내용을 정확히 그대로 설치하므로, 반복 설치로 인한 prune 동작을 방지할 수 있습니다.

colanode

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트