[도쿠위키 3편] 아파치와 도쿠위키 연동 및 서버 파일 업로드 실전 가이드
Index
서론: 구축 완료된 서버에 생명 불어넣기
도쿠위키 웹 인터페이스를 통한 미디어 업로드
서버 파일 시스템(백엔드)을 통한 수동 업로드 및 구조 이해
업로드 시 주의해야 할 권한 및 경로 에러 예방
마치며: 나만의 독립형 위키 서버 운영을 축하하며
1. 서론: 구축 완료된 서버에 생명 불어넣기
아파치(Apache) 서버를 무사히 설치하고 설정 오류까지 말끔하게 잡아냈다면, 이제 실제로 콘텐츠를 채워 넣을 차례입니다. 도쿠위키 환경에서 이미지, 첨부 파일, 그리고 텍스트 문서를 서버에 올리고 관리하는 방법을 확실하게 익혀두어야 원활한 위키 운영이 가능합니다. 이번 포스팅에서는 웹 화면을 통한 업로드와 서버 폴더를 직접 제어하는 수동 업로드 방식을 모두 정리해 드립니다.
2. 도쿠위키 웹 인터페이스를 통한 미디어 업로드
일반적인 문서 작성 중 이미지나 PDF, 압축 파일 등을 첨부하고 싶을 때는 도쿠위키가 제공하는 전용 기능을 사용하는 것이 가장 편리합니다.
웹 브라우저를 통해 본인의 도쿠위키 페이지에 접속합니다.
화면 상단 또는 하단에 위치한 [미디어 관리자 (Media Manager)] 버튼을 클릭합니다.
업로드하고자 하는 네임스페이스(폴더)를 선택한 뒤, 파일 업로드 탭을 통해 컴퓨터에 있는 파일을 드래그 앤 드롭하거나 선택하여 업로드합니다.
업로드된 이미지는 본문에서
{{namespace:filename.png}}형태로 간편하게 삽입할 수 있습니다.
💡 핵심 체크포인트 (미디어 파일 활용) 업로드한 파일명에 한글이나 특수문자가 포함되어 있으면 웹 브라우저 환경에 따라 깨짐 현상이 발생할 수 있습니다. 가급적 파일명은 영문 소문자와 하이픈(
-), 언더바(_) 조합으로 업로드하는 것을 추천합니다.
3. 서버 파일 시스템(백엔드)을 통한 수동 업로드 및 구조 이해
아파치 서버의 디렉터리 구조를 직접 제어할 수 있다면, 백엔드 폴더에 직접 접근하여 파일을 배치하는 것도 가능합니다. 도쿠위키는 데이터베이스가 없기 때문에 파일 시스템 구조가 곧 위키의 구조가 됩니다.
미디어 파일 저장 경로: 서버 내
data/media/폴더 하위에 파일들이 그대로 저장됩니다. 이 경로에 폴더를 만들고 파일을 직접 밀어 넣어도 미디어 관리자에서 곧바로 인식됩니다.텍스트 문서 직접 생성: 새로운 위키 페이지를 코드로 직접 만들고 싶다면
data/pages/하위에.txt확장자 파일을 생성하면 됩니다. (예:start.txt파일이 위키의 메인 대문 페이지 역할을 담당합니다.)
4. 업로드 시 주의해야 할 권한 및 경로 에러 예방
로컬 환경이나 자체 서버에서 파일을 올릴 때 간혹 파일을 읽지 못하거나(Permission denied 등) 저장되지 않는 문제가 발생할 수 있습니다.
아파치 프로세스가
data/폴더 및 하위 디렉터리에 대해 읽기/쓰기 권한을 가지고 있는지 반드시 확인해야 합니다.윈도우 환경에서는 파일 경로 내 슬래시 방향(
\vs/)이나 따옴표(") 누락으로 인해 설정이 꼬일 수 있으므로 언제나httpd.exe -t명령어로 문법 무결성을 먼저 체크하는 습관을 유지하세요.
5. 마치며
아파치 서버 설치부터 설정 오류 해결, 그리고 도쿠위키의 개념과 파일 업로드 실전까지 긴 여정을 함께 달려왔습니다. 이제 여러분의 로컬 PC 또는 서버 위에는 세상에서 가장 안전하고 가벼운 나만의 독립형 지식 아카이브가 완벽하게 동작하고 있습니다. 이 공간에 여러분만의 소중한 기록과 지식을 가득 채워나가시길 응원합니다!
