가이드

시놀로지 도커에 shlink 설치하기 - 짧은 주소 만들기

빨간물약

29 6월 2023 — 9 min read

요런 화면의 shlink라는 도커 컨테이너 입니다

긴 주소의 파일을 짧게 줄여주는 역할을 하는 서비스 인데요

시놀로지 도커에 설치 하려다 보니 기존의 가이드들이 좀 오래되서 시행착오를 겪었습니다

정리할겸 기록을 남겨 봅니다

우선 7.2 버전 기준의 가이드고요 도커 컴포즈를 이용해 설치를 해줄 겁니다

DB는 마리아DB 패키지를 이용해 줄 거기 때문에

마리아DB패키지와 phpmyadmin 패키지가 설치 돼있어야 합니다

그리고 SSL과 DDNS 세팅이 돼있어야 합니다

우선 마리아DB패키지를 이용할 것이기 때문에 DB생성을 먼저 해주겠습니다

마리아DB 패키지 설정은

TCP/IP 연결 활성화 체크 해주시고 3306 포트를 설정 해줍니다

이렇게 되면 시놀로지 내부의 도커 컨테이너 들이 마리아 DB에 접근이 가능 해집니다

그 후에 phpmyadmin을 실행 해주시고 root 유저로 접속 해주세요

접속 후 사용자 계정 - 사용자 추가를 해줍니다

사용자 이름은 shlink로 만들어 주시고 비번은 편한대로 만드시면 됩니다

저는 생성 버튼을 통해 랜덤생성 했습니다

생성한 비번은 따로 적어 두세요

동명의 DB 생성 체크 해주시고 권한 모두 체크 해주세요

그리고 쭉 내려서 좌측 하단 실행 눌러 주시면 DB와 사용자가 생성 됩니다

우선 DB관련 설정은 끝났습니다

그 다음은 DDNS 설정을 해주겠습니다

시놀로지 역방향 프록시를 사용하셔도 되고 NPM이나 caddy를 설정 하셨으면 그 걸로도 가능합니다

우리가 만들 역방향 프록시는 두 가지 입니다

짧은 주소를 만들었을 때 보여지는 DDNS와

짧은 주소를 만들기 위해 shlink에 접속할 주소

shlink는 별도의 로그인이 없기 때문에

보안을 위해 접속 주소를 만들지 않고 내부ip접속을 유지해도 관계 없습니다

혹은 클플 제로트러스트 같은 다른 인증 서비스를 활용해도 됩니다

우선 역방향 프록시 설정을 하기 전에 설명을 드리자면

shlink는 두 가지 컨테이너로 이뤄져 있습니다

주소를 짧게 만들어 주는 컨테이너 + shlink 웹 UI 컨테이너 입니다

주소를 짧게 만들어 주는 컨테이너는 8335포트를 사용할 거고요

웹UI 컨테이너는 8336포트를 사용할 겁니다

그리고 8335 포트 컨테이너는 url를 줄였을 때 짧아진 URL을 표시하기 때문에

url.내도메인.com 이란 형식으로 지정을 해줄 겁니다

웹UI 주소도 설정 하실 거면 8336포트 컨테이너는 shlink.내도메인.com이 되겠네요

설정은 간단하죠

역방향 프록시 기준으로 보시면

설정 - 로그인 포털 - 역방향 프록시 선택

우선 shlink URL 설정 입니다 HSTS 체크 해주시고요

사용자 지정 머리글에서 웹소켓 설정 해주세요

그리고 저장

두번 째는 웹UI 접속을 위한 설정입니다

이것도 웹소켓 넣어주시고 저장

그 후에 파일스테이션을 이용해 docker폴더에 shlink폴더를 만들어 주시면 됩니다

그럼 이제 사전 준비는 끝났습니다

컨테이너 매니저로 이동 해주시면 됩니다

프로젝트 생성을 누르시고 이름과 만들어 놓은 폴더를 선택 후 도커 컴포즈 만들기 선택

아래의 코드를 적어 줍니다

한글로 된 부분은 본인 설정에 맞게 수정 해주세요

version: "3.5"
services:
  shlink:
    image: shlinkio/shlink:stable
    container_name: shlink
    environment:
      - DB_HOST=나스IP
      - DB_PORT=3306
      - DB_USER=shlink
      - DB_PASSWORD=phpmyadmin에서 설정한 암호
      - DB_NAME=shlink
      - DB_DRIVER=maria
      - DEFAULT_DOMAIN=url.내도메인.com
      - IS_HTTPS_ENABLED=true
    ports:
      - 8335:8080
    restart: always
  shlink-web:
    image: shlinkio/shlink-web-client
    container_name: shlink-web
    restart: always
    environment:
      SHLINK_SERVER_NAME: 서버이름
      SHLINK_SERVER_URL: https://url.내도메인.com
    ports:
      - 8336:8080

복사