Trilium 이스톰 한국어판 2.0.0

Trilium 0.95.0용 한국어 배포판입니다. UI와 편집기 및 도움말과 API 참고 문서를 포함합니다. 새 문서에는 한국어 기본 예제와 한국어 PDF가 들어갑니다. 이미지 원본은 유지하고 한국어 설명을 제공합니다.

Dockerfile과 설치 스크립트가 최신 배포 파일을 사용하도록 통합했습니다. latest 대신 검증한 이미지 다이제스트를 고정합니다. 다른 Trilium 버전에 이 서버 번들을 덮어쓰지 마세요.

설치

Linux 서버의 Docker Engine과 Docker Compose 플러그인이 필요합니다. Compose는 up --wait를 지원해야 합니다. 저장소를 내려받을 때는 Git도 필요합니다. Docker 명령을 실행할 권한이 있는 계정으로 진행하세요.

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 이미지는 설치 중 로컬에서 빌드합니다. 이 저장소는 공개 컨테이너 레지스트리에 이미지를 올렸다고 가정하지 않습니다. 최초 빌드에는 고정된 기반 이미지 다운로드가 필요할 수 있습니다.

업데이트

현재 설치 폴더에서 실행합니다.

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가 필요할 수 있습니다.

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 사본은 운영 버전과 지원 범위가 다를 수 있음을 문서에 표시했습니다.

검증과 재생성

다음 버전의 추가 번역은 버전 업데이트와 추가 번역 절차를 따릅니다. 기존 한국어와 새 원문을 비교하는 도구 및 코드와 도움말 파일의 변경 확인 도구를 제공합니다. 현재 배포판의 지원 버전은 그대로 0.95.0입니다.

검증 결과는 배포 검증 기록에 있습니다. 배포 파일은 Docker 빌드 중 SHA-256 검사와 JavaScript 구문 검사를 통과해야 합니다. 개발 환경에 Node.js가 있다면 다음 명령으로도 확인할 수 있습니다.

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·설치 스크립트를 사용하세요. 상세 번역 내역은 변경 기록을 참고하세요.