개인정보와 안전한 공유
dtxWiki는 설치한 컴퓨터나 서버에 지식을 보관합니다. “로컬 우선”은 앱의 저장 위치를 뜻합니다. 페이지 공유 범위와 외부 서비스 연결은 사용자가 별도로 선택합니다.
누가 자료를 볼지 정하기
멤버에게만 공개할 자료는 비공개 워크스페이스에 보관합니다. 멤버십은 폴더 하나가 아닌 워크스페이스 전체에 적용됩니다. 작성자 전용 MCP 편집은 제출 전 본인만 봅니다. 브라우저 초안 저장·자동 저장은 같은 공간의 편집자·소유자도 읽을 수 있는 미게시 초안이며 작성자 전용이 아닙니다. 뷰어는 게시 버전을 봅니다. 검토 제출과 익명 웹 공개도 각각 별개입니다.
다음 세 가지 공유 동작을 구분하세요.
| 동작 | 접근할 수 있는 사람 |
|---|---|
| 멤버 추가 | 해당 계정이 선택한 역할로 워크스페이스에 접근 |
| 워크스페이스 페이지 링크 복사 | 필요한 접근 권한이 있는 로그인한 멤버만 열람 |
| 컨텍스트 버전을 웹에 게시 | 별도로 게시한 버전을 익명 방문자가 열람 |
공개 페이지는 참고문헌도 표시하지만 공개하지 않은 비공개 대상은 제목 없이 사용 불가로 표시합니다. 공개 문서에 등록했다고 대상까지 공개되지는 않습니다.
목록에 표시되지 않는 공개 URL도 주소를 얻은 사람이 읽을 수 있습니다. 비밀 초대가 아닌 외부 공유로 취급하세요. 공개 워크스페이스는 검색 가능한 프로필을 보여주며 내부 페이지를 모두 자동으로 게시하지는 않습니다. 게시 전 공유하기를 확인하세요.
나에게만 적용되는 선택도 있습니다. 내 즐겨찾기에 추가로 표시한 즐겨찾기는 나에게만 보이며 다른 멤버나 소유자에게는 보이지 않습니다. 즐겨찾기는 내 계정과 워크스페이스 기준으로 서버 데이터베이스에 저장됩니다. Ask 메뉴 표시 같은 설정 → 실험실의 선택은 현재 계정 기준으로 이 브라우저에만 저장됩니다. 서버로 전송되지 않으며 누구의 접근 권한도 바꾸지 않습니다.
AI의 데이터 접근 이해하기
MCP로 AI 앱을 연결하면 실행 중인 dtxWiki 서버에 자료와 허용된 동작을 요청할 수 있습니다. 내 계정·역할·선택한 워크스페이스·권한 범위를 사용합니다. 앱에 반환된 자료는 해당 앱의 AI 제공자 정책에 따라 처리될 수 있습니다. 필요한 공간과 동작만 허용하세요.
dtxWiki 자체 모델 제공자 설정은 별개입니다. 질문 기능은 제공자 없이도 동작합니다. 질문은 각자 설정 → 실험실에서 켜는 실험 중인 메뉴입니다. 제공자를 켜면 질문과 선택한 근거를 해당 서비스로 보내 답변을 작성합니다. 외부 임베딩 서비스는 의미 검색의 색인·질의에 사용할 텍스트를 받습니다. 외부 재순위 서비스는 순위를 매길 후보를 받습니다. 기본적으로 꺼져 있습니다. 선택적 AI 제공자를 참고하세요.
웹 자료를 라이브러리로 가져오면 자료의 원래 서버에 접속할 수 있습니다. 선택적인 계정 메일은 받는 사람 주소와 이메일 확인·복구·5분 본인 확인·계정 이메일 추가 링크를 설정된 메일 서비스로 전달합니다. 기본값에서는 메일이 꺼져 있고 계정 이메일 추가에는 비밀번호 로그인도 켜야 합니다. Gmail 예제와 수신 확인은 선택 사항: 이메일 발송을 참고하세요. 로컬 저장이 모든 선택적 동작의 네트워크 단절을 뜻하지는 않습니다.
액세스 키 보호
액세스 키, 또는 PAT는 부여한 권한으로 앱이 작업하도록 하는 자격 증명입니다. 비밀번호처럼 취급하세요.
- 사람과 연결마다 별도 키를 만들고 공동 키를 피합니다.
- 지식을 참고하기만 한다면 읽기 권한으로 시작합니다.
- 필요한 워크스페이스만 고릅니다. 설정 → MCP 접근에서 만든 키는 90일 뒤 만료됩니다. 워크스페이스 대화상자에서 선택을 적용하기 전에 선택한 항목 보기로 확인합니다.
- 새 키가 한 번 표시될 때 복사하여 승인된 비밀 저장소에 보관합니다.
- 잃어버리거나 노출된 키는 설정 → MCP 접근에서 폐기하고 새 키를 만듭니다. 그 키를 쓰던 클라이언트는 연결된 MCP 클라이언트에서 인증 취소로 표시됩니다. 워크스페이스 소유자는 비활성화로 특정 클라이언트를 즉시 멈출 수도 있으며, 이때 사용 차단으로 표시됩니다.
키·일회용 비밀번호 재설정 URL·.env·전체 클라이언트 설정을 공개 이슈, 설명서 화면 캡처, 공동 채팅에 붙여 넣지 마세요. 일부 클라이언트 설정에는 PAT가 평문으로 저장됩니다. 설정 도우미가 터미널 출력에서 키를 가려도 파일까지 비밀 저장소가 되는 것은 아닙니다. 해당 파일과 백업의 접근을 제한하세요.
OAuth는 PAT를 설정 파일에 직접 넣는 과정을 줄여 주지만 앱은 여전히 토큰과 권한을 받습니다. 동의 화면을 읽고 사용하지 않는 앱의 승인을 취소하세요.
페이지에 올린 파일
페이지에 올린 파일은 해당 워크스페이스와 함께 dtxWiki 서버에 저장됩니다. 설정 → 첨부 파일에서는 각 멤버가 조회할 수 있는 페이지의 업로드를 봅니다. 뷰어와 편집자는 자신이 올린 파일을, 소유자는 다른 멤버가 올린 파일도 봅니다. 다른 사람의 작성자 전용 편집에 있는 업로드는 보이지 않습니다. 브라우저 초안은 문서의 편집자·소유자 공개 범위를 따릅니다.
어떤 페이지 버전에서도 쓰이지 않는 업로드는 미사용입니다. dtxWiki는 업로드 후 워크스페이스의 보존 기간이 지난 미사용 업로드를 자동으로 삭제합니다. 서버 기본값이나 워크스페이스 설정을 바꾸지 않았다면 보존 기간은 7일입니다. 소유자는 미사용 파일 자동 회수에서 기간을 바꾸거나, 자동 정리를 끄거나, 서버 기본값으로 되돌릴 수 있습니다. 어떤 페이지 버전에서든 쓰이는 파일과 아직 열려 있는 편집에 포함된 파일은 이 방식으로 삭제되지 않으며, 라이브러리 자료도 영향을 받지 않습니다. 설정 → 첨부 파일에서 파일을 삭제하면 영구히 삭제되며 백업으로만 되살릴 수 있습니다.
서버 관리자는 서버 전체의 첨부 파일 정보를 볼 수 있습니다. 첨부 파일 조회 범위를 전체 워크스페이스로 바꾸면 관리자가 멤버가 아닌 곳을 포함한 모든 워크스페이스의 워크스페이스 이름, 파일 이름, 페이지 제목, 업로드한 사람, 업로드 시각을 보고 미사용 파일을 삭제할 수 있습니다. 이 화면은 미리보기나 파일 내용을 보여 주지 않으며, 페이지를 열거나 워크스페이스의 정리 설정을 바꾸는 권한도 주지 않습니다.
운영 담당자 안내
원격 접속은 HTTPS를 사용합니다. 외부 노출 포트를 제한하고 전달 헤더는 실제 프록시에서 온 것만 신뢰합니다. 일반 재시작에서는 서명 키와 세션 비밀값을 유지하고 보호된 백업에 포함합니다. 로컬 설치는 이를 자동으로 처리합니다. 데이터 디렉터리(기본값 ~/.dtxwiki)에 OAuth 서명 키 oauth-jwt.pem과 session_secret을 만들고 시작할 때마다 다시 사용합니다. 두 파일을 비밀번호처럼 보호하고, 데이터를 백업하거나 옮길 때 함께 보관하세요.
데이터 디렉터리와 SQLite 데이터베이스가 있는 폴더에는 .lock 파일도 있습니다. dtxWiki는 이 파일로 두 번째 dtxWiki가 같은 데이터를 동시에 쓰지 못하게 막습니다. dtxWiki를 중지한 뒤에도 남아 있으며, 삭제하지 마세요.
DTXWIKI_CONTEXT_MEDIA_ORPHAN_RETENTION_HOURS는 미사용 업로드 보존 기간의 서버 기본값을 정하며, 바꾸지 않으면 168시간입니다. 0이면 기본값을 따르는 워크스페이스의 자동 정리가 꺼집니다. 소유자가 워크스페이스에 저장한 값이 우선합니다. 값을 바꾼 뒤에는 dtxWiki를 다시 시작하고, 작업자를 별도로 실행한다면 작업자도 다시 시작하세요. 제공되는 Docker Compose 파일은 이 변수를 전달하지 않으므로, Compose 설정에 추가하지 않으면 Docker 설치는 168시간을 유지합니다.
SQLite 파일과 업로드는 운영체제 접근 권한과 디스크·백업 보호가 필요합니다. 앱의 접근 제어가 디스크 암호화를 대신하거나 파일시스템 권한을 가진 서버 운영자의 데이터 읽기를 막지는 않습니다. 이 버전은 단일 데이터베이스 안에서 워크스페이스를 논리적으로 분리합니다.
오류를 숨기려고 보안 검사를 끄지 마세요. 문제 해결로 설정·인증서 문제를 해결하세요. 키 교체, 복구, 버전 변경 전에는 백업과 유지보수를 확인합니다.
외부 신원과 계정 삭제
외부 로그인은 별도 제공자 플러그인과 IdP 정책을 따르며 이메일 일치만으로 계정을 합치지 않습니다. 계정 삭제는 자격 증명을 즉시 폐기하지만 다른 워크스페이스의 제출 문서·검토·대화 이력은 보존합니다. 보존 기간과 마지막 관리자 공간의 처리 범위를 먼저 확인하세요. 그래프·Inbox도 현재 사용자의 접근 권한을 따릅니다.
버전 근거: 공유 화면 규칙, 멤버·키 제어, 제공자·저장소 설정, 연결된 클라이언트 상태, 개인 즐겨찾기, 브라우저에 저장되는 실험실 선택, 첨부 파일 화면, 미사용 파일 보존 기간, 서버 전체 첨부 파일 목록, 로컬 서명 키, 잠금 파일.