deepin 20 환경에서 이미지 호스팅 시스템 구성

deepin 20 운영체제는 우수한 사용자 인터페이스와 안정적인 기본 애플리케이션 제공으로, 특히 윈도우 사용자에게도 자연스러운 전환 경험을 제공합니다. 이 글에서는 이 시스템에서 Typora와 연동 가능한 이미지 업로드 서비스를 구축하는 과정을 상세히 설명합니다.

최신 버전의 Typora 설치

deepin 앱 스토어에 포함된 Typora는 오래된 버전(0.9.86)을 사용하고 있어, 일부 기능이 제대로 작동하지 않습니다. 예를 들어, 저장된 마크다운 파일 내에서 이미지를 붙여넣기 시 자동 업로드가 동작하지 않는 문제가 발생합니다. 이를 해결하기 위해 공식 홈페이지에서 제공하는 최신 버전(0.9.93)을 수동으로 설치해야 합니다.

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys BA300B7755AFCFAE
wget -qO - https://typora.io/linux/public-key.asc | sudo apt-key add -
echo 'deb https://typora.io/linux .' | sudo tee -a /etc/apt/sources.list
sudo apt-get update
sudo apt-get install typora

PicGo GUI 설치 및 실행 문제 해결

공식 릴리즈 페이지에서 PicGo-2.3.0-beta.3.AppImage를 다운로드 후 실행 시 보안 샌드박스 오류가 발생할 수 있습니다:

[FATAL:setuid_sandbox_host.cc(157)] The SUID sandbox helper binary was found, but is not configured correctly...

해결 방법은 다음과 같습니다:

1. 시스템에 사용자 네임스페이스 활성화: sudo sysctl kernel.unprivileged_userns_clone=1
2. 지속적인 적용을 위해 설정 파일 생성: echo 'kernel.unprivileged_userns_clone=1' | sudo tee /etc/sysctl.d/userns.conf

재부팅 후에는 정상적으로 애플리케이션이 실행됩니다.

Gitee 이미지 저장소 설정

무료이며 빠른 업로드 속도를 제공하는 Gitee를 이미지 호스팅 플랫폼으로 선택합니다.

• 새로운 저장소 생성: 예시로 Picture-bed라는 이름의 공개 저장소 생성
• Personal Access Token 발급: 프로필 > 설정 > 개인 토큰 > projects 권한만 활성화 후 토큰 생성

Gitee 업로더 플러그인 설치

GUI 환경에서 gitee-uploader 플러그인을 설치하려면 먼저 nodejs와 npm가 필요합니다:

sudo apt-get install nodejs npm

설치 후 재시작하여 플러그인 설치 완료. 이후 이미지 업로드 설정에서 repo: 사용자명/Picture-bed, branch: master, path: /img, token: 발급받은 값 입력.

picgo-core 설정 및 통합

GUI로 설정한 내용을 명령줄 도구 picgo-core에 반영해야 합니다.

# cnpm 설치 (국내 레파지토리 활용)
sudo npm install -g cnpm --registry=https://registry.npm.taobao.org

# picgo-core 설치
sudo cnpm install picgo -g

# Gitee 업로더 플러그인 설치
picgo install gitee-uploader

설치 후 ~/.picgo/config.json 파일을 수정하여 아래와 같이 구성합니다:

{
  "picBed": {
    "current": "gitee",
    "uploader": "gitee",
    "gitee": {
      "branch": "master",
      "path": "/img",
      "repo": "Alex-GCX/Picture-bed",
      "token": "your-gitee-token-here"
    }
  },
  "picgoPlugins": {
    "picgo-plugin-gitee-uploader": true
  }
}

Typora와 연동 설정

Typora의 설정에서 이미지 업로드 방식을 Custom Command로 변경하고, 다음 명령어를 입력합니다:

/usr/bin/node /usr/local/bin/picgo upload

경로는 which node 및 which picgo 명령어로 확인 가능합니다. 설정 후 테스트 업로드를 통해 정상 작동 여부를 확인합니다.

업로드 실패 시, 같은 이미지를 반복 업로드하면 중복 오류가 발생하므로, Gitee 저장소에서 해당 파일을 삭제한 후 다시 시도하세요.