[시놀로지 NAS] Docker로 Redmine 설치 (DSM 7.3, ds218+)

Posted on 2025. 12. 31. 21:07
Filed Under 시놀로지NAS활용

[시놀로지 NAS] Docker로 Redmine 설치하기 (삽질기 포함)

안녕하세요! 오늘은 시놀로지 NAS에 프로젝트 관리 도구인 Redmine을 설치하는 과정을 정리해보려 합니다. 처음 시도하면서 꽤 많은 시행착오(삽질)를 겪었는데, 저처럼 고생하지 마시라고 A부터 Z까지 상세하게 기록해 둡니다. 나중에 저도 다시 볼 겸요. ^^;

0. 전체 구조 이해하기 (우리가 만들 집의 설계도)

Redmine을 설치하려면 총 3가지의 컨테이너(방)가 필요합니다.

MariaDB (금고): Redmine의 모든 데이터(회원 정보, 일감, 게시글 등)를 안전하게 보관하는 데이터베이스입니다. 가장 중요합니다.
phpMyAdmin (창문): 터미널의 검은 화면 대신, 웹 브라우저에서 마우스로 편하게 MariaDB 금고 안을 들여다보고 관리할 수 있게 해주는 관리 도구입니다.
Redmine (장부): 우리가 실제로 사용할 프로젝트 관리 프로그램입니다. MariaDB 금고에 데이터를 저장하고 불러옵니다.

🤔 Web Station, 꼭 설치해야 할까? (중요!)

많은 블로그에서 Web Station을 먼저 설치하라고 하지만, 결론부터 말하면 Docker로 설치할 때는 필수가 아닙니다. 오히려 저처럼 포트 충돌(특히 80번 포트) 문제로 삽질하게 만드는 원인이 될 수 있습니다.

설치 목적: Web Station은 NAS 자체를 하나의 웹 서버로 만들 때 사용합니다.
결론: Docker 컨테이너는 그 자체로 독립된 서버 역할을 하므로 Web Station 없이도 충분히 운영 가능합니다. 굳이 설치해서 포트 문제를 일으킬 필요가 없습니다.

1. 준비물 및 사전 작업 (폴더 만들기)

가장 먼저, 데이터가 저장될 '실제 창고'(폴더)를 만들어야 합니다. 이 단계를 건너뛰면 컨테이너가 실행되지 않거나, 열심히 작업한 데이터가 날아갈 수 있습니다.

1. File Station에서 폴더 생성:
docker 폴더 아래에 다음과 같이 폴더를 만들어 주세요.

/docker/mariadb (DB 데이터 저장용)
/docker/redmine/files (Redmine 첨부파일 저장용)
/docker/redmine/plugins (Redmine 플러그인 저장용)

2. 권한 설정 (매우 중요! ⭐⭐⭐):
만든 폴더 각각에 대해 읽기/쓰기 권한을 주어야 합니다. (저는 이것 때문에 한참 고생했습니다 ㅠㅠ)

각 폴더 우클릭 -> [속성] -> [권한] 탭으로 이동.
[생성] 클릭 -> 사용자/그룹에 Everyone 선택 -> [읽기] 및 [쓰기] 체크.
하단의 '이 폴더, 하위 폴더 및 파일에 적용' 체크 후 저장.

2. Step 1: MariaDB (데이터베이스 금고) 설치

1. 이미지 다운로드:
Container Manager -> [레지스트리]에서 mariadb 검색. 가장 상단의 공식 이미지(latest 또는 11.4)를 다운로드합니다. (저는 ubi 버전을 받았다가 권한 문제로 고생했으니 일반 버전을 추천합니다.)

2. 컨테이너 생성 및 설정:

포트 설정: 로컬 포트 3306, 컨테이너 포트 3306 (기본값 그대로 사용).
볼륨 설정:
파일/폴더: /docker/mariadb (아까 만든 폴더 선택)
마운트 경로: /var/lib/mysql (직접 입력)

코멘트: 이 설정이 있어야 컨테이너를 삭제해도 데이터가 안전하게 남습니다.

환경 변수 설정 (필수):
변수: MARIADB_ROOT_PASSWORD (또는 MYSQL_ROOT_PASSWORD)
값: (사용할 강력한 비밀번호 입력)

3. 설치 확인:
컨테이너 실행 후 [로그] 탭에 ready for connections 문구가 뜨면 성공!

3. Step 2: phpMyAdmin (DB 관리 도구) 설치

1. 이미지 다운로드: phpmyadmin 검색 후 다운로드.

2. 컨테이너 생성 (Web Station 충돌 해결!):
첫 화면에서 'Web Station을 통해 웹 포털 설정' 체크를 반드시 해제하세요. 이걸 해제해야 포트 충돌 없이 원하는 포트를 설정할 수 있습니다.

3. 상세 설정:

포트 설정: 로컬 포트 8080 (웹 주소창에 쓸 번호), 컨테이너 포트 80 (고정).
링크 설정: 아까 만든 MariaDB 컨테이너 선택, 별칭(Alias)에 db 입력.
환경 변수 설정:
변수: PMA_HOST
값: db (링크 별칭 입력)

코멘트: PMA_HOST에 링크 별칭을 적어주면 IP 주소가 바뀌어도 알아서 MariaDB를 찾아갑니다.

볼륨 설정: 필요 없음 (데이터 저장 안 함).

4. 접속 확인: 웹 브라우저에 http://NAS아이피:8080 입력. ID는 root, 비밀번호는 MariaDB에서 설정한 값을 넣고 로그인해 봅니다.

4. Step 3: Redmine용 데이터베이스 생성

Redmine을 설치하기 전에 Redmine이 사용할 빈 금고(데이터베이스)를 미리 만들어줘야 합니다.

phpMyAdmin에 접속합니다.
상단 [데이터베이스] 탭 클릭.
새 데이터베이스 이름에 redmine 입력, 문자 집합은 utf8mb4_general_ci 선택 후 [만들기] 클릭.

5. Step 4: Redmine (프로젝트 관리 도구) 설치

1. 이미지 다운로드: redmine 검색 후 공식 이미지 다운로드.

2. 컨테이너 생성 및 설정:

포트 설정: 로컬 포트 3000, 컨테이너 포트 3000.
볼륨 설정:
/docker/redmine/files ↔ /usr/src/redmine/files
/docker/redmine/plugins ↔ /usr/src/redmine/plugins (필요시)

링크 설정: MariaDB 컨테이너 선택, 별칭 db 입력.

3. 환경 변수 설정 (가장 중요! ⭐⭐⭐):
이 부분을 정확히 입력해야 Redmine이 MariaDB와 연결됩니다.

REDMINE_DB_MYSQL: db (링크 별칭)
REDMINE_DB_DATABASE: redmine (아까 만든 DB 이름)
REDMINE_DB_USERNAME: root
REDMINE_DB_PASSWORD: (MariaDB 비밀번호)

4. 설치 확인:
Redmine은 처음 실행 시 DB 테이블을 만드느라 시간이 꽤 걸립니다(3~5분). [로그] 탭에 Listening on http://0.0.0.0:3000 문구가 뜰 때까지 느긋하게 기다려 주세요.

또는 아래이미지와 같이 [터미널]로 접속하여 명령어로 확인하는 방법도 있습니다.

6. 마무리

이제 모든 설치가 끝났습니다!

내부 접속 테스트: 같은 네트워크(집) 안에서 브라우저에 http://NAS아이피:3000을 입력해 보세요. Redmine 초기 화면이 뜬다면 성공입니다! (초기 계정: admin / admin)
외부 접속 (집 밖에서): 카페나 회사에서 접속하려면 사용 중인 공유기 설정 페이지에서 3000(Redmine), 8080(phpMyAdmin), 3306(MariaDB) 포트에 대한 포트포워딩 설정이 필요합니다. (이 부분은 각자 공유기 매뉴얼을 참고해주세요!)

긴 글 따라오시느라 고생 많으셨습니다. 저의 삽질 기록이 여러분의 성공적인 설치에 도움이 되기를 바랍니다! 😊