88 lines
6.3 KiB
Markdown
88 lines
6.3 KiB
Markdown
# Trilium 이스톰 한국어판 2.0.0
|
|
|
|
Trilium 0.95.0용 한국어 배포판입니다. UI와 편집기 및 도움말과 API 참고 문서를 포함합니다. 새 문서에는 한국어 기본 예제와 한국어 PDF가 들어갑니다. 이미지 원본은 유지하고 한국어 설명을 제공합니다.
|
|
|
|
Dockerfile과 설치 스크립트가 최신 배포 파일을 사용하도록 통합했습니다. `latest` 대신 검증한 이미지 다이제스트를 고정합니다. 다른 Trilium 버전에 이 서버 번들을 덮어쓰지 마세요.
|
|
|
|
## 설치
|
|
|
|
Linux 서버의 Docker Engine과 Docker Compose 플러그인이 필요합니다. Compose는 `up --wait`를 지원해야 합니다. 저장소를 내려받을 때는 Git도 필요합니다. Docker 명령을 실행할 권한이 있는 계정으로 진행하세요.
|
|
|
|
```bash
|
|
git clone https://gitea.itosm.co.kr/syskiller/triliumnext-korean-patch.git
|
|
cd triliumnext-korean-patch
|
|
cp .env.example .env
|
|
bash install.sh
|
|
```
|
|
|
|
기본 주소는 `http://127.0.0.1:8082`입니다. 서버에 리버스 프록시가 있다면 이 주소로 연결하세요. 직접 외부 접속을 허용하려면 `.env`의 `TRILIUM_KO_BIND`를 서버의 수신 주소로 변경하세요. 모든 인터페이스를 사용할 값은 `0.0.0.0`입니다. 포트는 `TRILIUM_KO_PORT`에서 바꿉니다.
|
|
|
|
브라우저에서 새 문서를 만들고 비밀번호를 설정하세요. 언어 및 지역 설정에서 한국어를 선택하고 새로 고칩니다. 기존 계정의 언어 설정은 업데이트 때 유지합니다.
|
|
|
|
Docker 이미지는 설치 중 로컬에서 빌드합니다. 이 저장소는 공개 컨테이너 레지스트리에 이미지를 올렸다고 가정하지 않습니다. 최초 빌드에는 고정된 기반 이미지 다운로드가 필요할 수 있습니다.
|
|
|
|
## 업데이트
|
|
|
|
현재 설치 폴더에서 실행합니다.
|
|
|
|
```bash
|
|
git pull --ff-only
|
|
bash install.sh
|
|
```
|
|
|
|
스크립트는 새 이미지를 먼저 빌드합니다. 이후 이 Compose 프로젝트의 Trilium을 중지하고 데이터 전체를 `backups/날짜-번호/data.tar.gz`로 백업합니다. 새 컨테이너의 상태 검사를 통과해야 배포 성공으로 표시합니다. 기동 실패 시 이전 이미지로 복귀를 시도하며 백업은 보존합니다. 데이터베이스는 실패 시 자동으로 덮어쓰지 않습니다.
|
|
|
|
새 설치용 예제 압축 파일을 바꿔도 기존 노트는 다시 가져오거나 덮어쓰지 않습니다. 기존 영어 예제나 사용자가 수정한 노트의 본문을 이 설치 스크립트가 임의로 번역하지 않습니다. 이스톰 운영 서버의 기존 노트 번역 기록은 `updates/2026-09-05`에 별도로 남아 있습니다.
|
|
|
|
## 기존 다른 컨테이너에서 이전
|
|
|
|
이 배포판은 Trilium 0.95.0과 같은 데이터 형식으로 검사했습니다. 더 최신 버전에서 쓰던 DB를 이전 버전으로 되돌리는 용도로 사용하지 마세요.
|
|
|
|
1. 기존 Trilium을 중지하고 데이터 폴더 전체를 백업합니다.
|
|
2. 기존 데이터를 별도 복사한 경로를 `.env`의 `TRILIUM_KO_DATA_DIR`로 지정합니다.
|
|
3. 다른 포트로 이 배포판을 설치해 노트와 첨부 파일을 확인합니다.
|
|
4. 확인 후 리버스 프록시의 연결 대상을 변경합니다.
|
|
|
|
하나의 데이터 폴더를 두 컨테이너에서 동시에 열지 마세요. 설치 스크립트는 같은 데이터 경로를 사용 중인 다른 컨테이너가 있으면 중단합니다. 기존 컨테이너의 bind mount 패치 설정은 새 컨테이너에 추가하지 않습니다. 모든 패치는 이미지 안에 포함돼 있습니다.
|
|
|
|
## 백업 복원
|
|
|
|
복원 전 현재 컨테이너를 중지하세요. 백업을 새 빈 데이터 폴더에 풀고 `.env`의 데이터 경로를 그 폴더로 바꾸는 방식을 권장합니다. 원래 폴더는 확인이 끝날 때까지 보존하세요. 백업 파일은 컨테이너의 root 권한으로 생성돼 `sudo`가 필요할 수 있습니다.
|
|
|
|
```bash
|
|
docker compose stop trilium
|
|
sudo mkdir /srv/trilium-restored
|
|
sudo tar -xzpf backups/복원할-백업/data.tar.gz -C /srv/trilium-restored
|
|
# .env의 TRILIUM_KO_DATA_DIR을 /srv/trilium-restored로 수정한 뒤 실행
|
|
bash install.sh
|
|
```
|
|
|
|
이전 이미지의 복구용 태그는 `previous-image.txt`에 있으며 원래 ID는 `previous-image-id.txt`에 있습니다. 이미지 복귀만으로 DB 형식이 되돌아가지는 않으므로 다른 버전 사이의 복원에서는 해당 버전의 데이터 백업을 함께 사용하세요.
|
|
|
|
## 포함 범위
|
|
|
|
| 항목 | 내용 |
|
|
|---|---|
|
|
| 기반 앱 | Trilium 0.95.0 |
|
|
| 기반 이미지 | `triliumnext/notes@sha256:611a430016585d35b170eb9a0fa300ce76318f04a8ec0067549c4c52561b0c36` |
|
|
| UI | 한국어 사전과 편집기 및 지도·달력·마인드맵 수정 |
|
|
| 도움말 | 본문 173개와 제목 181개 |
|
|
| 이미지 설명 | 영문이 감지된 이미지 206개에 한국어 설명 |
|
|
| API 참고 화면 | 5개와 Swagger 정적 파일 |
|
|
| 신규 기본 예제 | 노트 170개 대응 및 번역 수정 148개와 한국어 PDF |
|
|
| 배포 파일 | `release/manifest.json`의 492개 파일 |
|
|
|
|
함수 이름과 코드 문법 및 URL과 제품 이름은 원문을 유지합니다. 연결된 외부 사이트 전체를 번역한 것은 아닙니다. 외부 스크립트 API 사본은 운영 버전과 지원 범위가 다를 수 있음을 문서에 표시했습니다.
|
|
|
|
## 검증과 재생성
|
|
|
|
검증 결과는 [배포 검증 기록](docs/DEPLOYMENT-TESTS.ko.md)에 있습니다. 배포 파일은 Docker 빌드 중 SHA-256 검사와 JavaScript 구문 검사를 통과해야 합니다. 개발 환경에 Node.js가 있다면 다음 명령으로도 확인할 수 있습니다.
|
|
|
|
```bash
|
|
node tools/verify-release.mjs
|
|
```
|
|
|
|
기록된 번역 단계와 `release/demo-ko.zip`에서 배포 트리를 다시 모으려면 `node tools/build-release.mjs`를 실행합니다. 예제 압축 파일 생성 원본과 ID 대응 자료는 `tools/demo-source`에 보관했습니다. 과거 일회성 운영 DB 마이그레이션 코드는 일반 배포 번들에서 제거했습니다.
|
|
|
|
`legacy/v1`과 `patch-only` 및 기존 v1.0.0 첨부 파일은 과거 배포판입니다. 신규 설치에는 이 문서와 루트의 Dockerfile·설치 스크립트를 사용하세요. 상세 번역 내역은 [변경 기록](updates/2026-09-05/CHANGELOG.ko.md)을 참고하세요.
|