Obsidian 플러그인

Obsidian용 Aktar

노트는 가볍게, 첨부 파일은 내 S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO 버킷에 두세요. 파일을 붙여넣거나 드롭하면 버킷으로 가고, 이미 있는 첨부 파일도 옮길 수 있습니다. 모든 링크는 일반 https:// URL이라 플러그인이 있든 없든 작동합니다.

무료, 오픈 소스. 데스크톱, iPhone, iPad, Android에서 Obsidian 1.11.4 이상.

일반 링크, 종속 없음

Aktar는 임베드를 버킷 URL을 쓰는 표준 Markdown 이미지로 바꿉니다. 크기와 캡션은 그대로이고, 노트의 모양도 달라지지 않습니다.

보관함 안![[IMG_2041.png|300]]
내 버킷 안![300](https://files.example.com/obsidian/Notes/2026/10/aB3xK9q.png)
  • 노트는 몇 킬로바이트로 유지되고, Obsidian Sync, iCloud, Git 등 지금 쓰는 방식 그대로 동기화됩니다.
  • 링크는 어떤 Markdown 앱에서도, GitHub에서도, 브라우저에서도, 플러그인 없는 Obsidian에서도 작동합니다. 플러그인을 제거해도 아무것도 깨지지 않습니다.
  • 언제든 마음을 바꿀 수 있습니다. Bring files back은 파일을 보관함으로 내려받고 링크를 다시 일반 첨부 파일 링크로 바꿉니다.

할 수 있는 모든 것

플러그인은 Aktar 앱과 같은 대상, 경로 템플릿, 규칙을 사용합니다. 그래서 Obsidian에서 업로드한 파일은 Mac이나 휴대폰에서 올린 파일과 같은 곳에 들어갑니다.

  • 붙여넣기와 드롭

    붙여넣거나 드롭한 파일은 곧바로 노트에 자리 표시자로 들어가고, 업로드가 끝나면 링크가 됩니다. 붙여넣거나 드롭할 때 버킷으로 보낼 것을 이미지, 모든 파일, 없음 중에서 고르고, 새 이미지 임베드의 기본 너비도 정할 수 있습니다.

  • 기존 첨부 파일 옮기기

    노트 하나 또는 보관함 전체의 첨부 파일을 옮깁니다. 실제로 옮기기 전에 시험 실행으로 바뀌는 파일과 노트를 모두 보여 줍니다. 프런트매터, 코드 블록, 캔버스에 있는 링크와 그 파일은 건드리지 않습니다. 로컬 사본은 휴지통으로 가거나, 원하면 그대로 남습니다.

  • 어떤 옮기기든 실행 취소

    Undo the last move to the bucket은 파일을 보관함으로 다시 내려받고 모든 링크를 원래대로 되돌립니다.

  • 파일 되가져오기

    노트의 파일을 버킷에서 보관함으로 내려받습니다. 링크는 일반 첨부 파일 링크가 되며, Obsidian의 링크 설정대로 작성됩니다. 위키링크 또는 Markdown, 가장 짧은 경로 또는 상대 경로입니다.

  • 새 첨부 파일 자동으로 옮기기

    휴대폰에서 첨부한 사진이나 다른 플러그인이 보관함에 저장한 파일은 노트에 임베드되는 순간 버킷으로 옮겨집니다. 어떤 노트에도 링크되지 않은 파일은 그대로 둡니다. 원하면 폴더 하나로 범위를 좁힐 수 있습니다.

  • 비공개 버킷

    노트에는 일반 링크가 남고, 플러그인은 기기에서 서명한 1시간짜리 URL로 파일을 보여 줍니다. 키가 없는 사람은 열 수 없습니다.

  • 라이브러리

    세 가지 보기가 있는 사이드 패널입니다. 노트가 쓰는 버킷 파일과 그 위치, 버킷의 폴더와 파일, 업로드 대기열을 보여 줍니다. 더 이상 어떤 노트에도 링크되지 않은 파일을 찾아, 확인을 거쳐 한 번에 삭제할 수 있습니다.

  • 링크 작업

    링크를 오른쪽 클릭해 복사하거나, 1시간, 1일, 7일 동안 유효한 링크를 복사하거나, 열거나, 파일을 보관함으로 가져오거나, 버킷에서 삭제하세요. 삭제하기 전에 어떤 노트가 그 파일에 링크하는지 알려 줍니다.

  • 더 작은 사진

    업로드 전에 사진을 WebP로 변환할 수 있습니다. 같은 화질에서 JPEG의 약 3분의 1 크기입니다. 3840, 2560, 1920, 1280, 1024픽셀로 줄일 수도 있습니다. GIF와 SVG는 건드리지 않습니다. WebP를 만들 수 없는 기기(iPhone, iPad)에서는 사진이 JPEG가 됩니다.

  • 사진에 위치 정보 없음

    사진을 찍은 위치는 사진이 기기를 떠나기 전에 제거됩니다. 사진 자체는 바뀌지 않습니다.

  • 오프라인에서도 작동

    본 적 있는 이미지는 정한 용량까지 기기에 보관되므로, 연결 없이도 노트에 표시됩니다. 업로드는 대기열에서 기다리며, 오프라인이 되거나 Obsidian을 다시 시작해도 사라지지 않고, 연결이 돌아오면 알아서 올라갑니다.

  • Aktar 앱과 함께

    Aktar가 설치된 Mac이나 PC에서는 클릭 한 번으로 플러그인을 앱과 연결하세요. 그러면 업로드가 Aktar를 거치며 Aktar의 대상, 키, 기록, 훅을 사용하고, Obsidian은 키를 전혀 보지 못합니다.

  • 노트 게시

    노트를 이미지와 함께 내 버킷의 웹 페이지로 만들고, 링크가 복사됩니다. 영구 링크나 7일 동안 작동하는 링크를 고르세요(비공개 버킷에서는 항상 7일). 페이지는 스크립트를 실행할 수 없으며, Take down으로 내릴 수 있습니다.

  • 보관함 백업

    보관함 전체를 zip으로 묶어 매일 또는 매주, 아무도 추측할 수 없는 이름으로 버킷에 보내고, 최신 3, 7, 14, 30개를 남깁니다. 가장 오래 켜져 있는 기기 한 대에서 켜세요. 다른 플러그인이 비밀번호를 보관할 수 있으므로, Obsidian 설정 폴더는 직접 포함하지 않는 한 제외됩니다.

  • 내 폴더 구조

    기본적으로 보관함마다 버킷 안에 자기 폴더 obsidian/{vault}/{year}/{month}/{short}.{ext}가 생깁니다. 노트의 이름이나 폴더, 날짜, 원래 파일 이름, 짧은 코드를 사용할 수 있습니다. 옮긴 파일은 파일에만 따라 정해지는 이름을 받으므로, 동기화된 두 기기가 같은 파일을 옮겨도 같은 객체와 같은 링크를 씁니다.

  • 모든 기기에서

    같은 플러그인이 Mac, Windows, Linux와 iPhone, iPad, Android용 Obsidian에서 작동합니다. 대상은 보관함과 함께 동기화되지만 키는 동기화되지 않으며, 각 기기가 전송 코드로 한 번 받습니다.

설정하기

Obsidian의 커뮤니티 플러그인(Settings › Community plugins › Browse)에서 Aktar를 설치하고 켜세요. 그런 다음 세 가지 방법 중 하나로 대상을 추가합니다.

1

Aktar 앱에서

  1. Mac, PC, iPhone, Android 휴대폰의 Aktar에서 대상을 열고 다른 기기로 전송을 선택하세요. 전송 링크를 복사합니다.
  2. Obsidian에서 Settings › Aktar › Add from Aktar app을 엽니다. 링크는 클립보드에서 채워집니다.
  3. Aktar가 보여 주는 12자리 코드를 입력하세요. 키는 암호화된 채로 전달되고, 대상이 준비됩니다.
2

이 컴퓨터의 Aktar와 연결

  1. Mac용 Aktar 0.19 또는 Windows용 0.12 이상을 설치하고, 그곳에서 대상을 추가하세요.
  2. Obsidian에서 Settings › Aktar › Aktar app을 열고 Connect를 클릭합니다.
  3. Aktar가 보여 주는 대화상자에서 Connect를 클릭하세요. Aktar의 대상이 플러그인에 나타나고, 업로드는 앱을 거칩니다.
3

직접 입력

  1. Settings › Aktar에서 Add manually를 선택하세요.
  2. 엔드포인트, 버킷, 리전, 공개 URL, 키를 입력합니다. 제공업체별로 어디서 찾는지는 설정 가이드에 나와 있습니다.
  3. 연결을 테스트하고 저장하세요.

명령

모든 작업이 명령 팔레트에 있으므로, Settings › Hotkeys에서 단축키를 지정할 수 있습니다. 자주 쓰는 것은 편집기의 오른쪽 클릭 메뉴에도 있습니다.

Upload a file into this note
파일을 골라 업로드하고 노트의 커서 위치에 넣습니다.
Move this note’s attachments to the bucket
시험 실행 후, 열린 노트의 첨부 파일을 옮깁니다.
Move attachments to the bucket…
시험 실행 후, 보관함 전체나 폴더의 첨부 파일을 옮깁니다.
Bring this note’s files back into the vault
열린 노트의 버킷 파일을 보관함으로 내려받고 링크를 첨부 파일 링크로 바꿉니다.
Undo the last move to the bucket
마지막 옮기기를 되돌립니다. 파일이 돌아오고 링크도 원래대로 돌아갑니다.
Open the library
사이드 패널에 라이브러리를 엽니다.
Publish this note as a web page
열린 노트를 내 버킷의 웹 페이지로 만들고 링크를 복사합니다.
Take down this note’s web page
열린 노트의 웹 페이지를 버킷에서 삭제합니다.
Back up the vault now
일정과 관계없이 지금 보관함을 zip으로 묶어 버킷에 보냅니다.
Retry uploads
대기 중인 업로드를 다시 시도합니다.
Save failed uploads into the vault instead
계속 실패하는 업로드를 보관함에 저장해, 아무것도 잃지 않게 합니다.
Add a destination from an Aktar app
전송 링크와 코드로 대상을 추가합니다.

키는 기기에 남습니다

대상은 플러그인 설정에 저장되며, 설정은 보관함과 함께 동기화됩니다. 키는 절대 그곳에 들어가지 않습니다. 키는 각 기기의 Obsidian 비밀 저장소에 보관되고 이 저장소는 동기화되지 않으므로, 공유하거나 Git에 올린 보관함에는 키가 없습니다.

대상은 있지만 키가 없는 기기는 그 사실을 알리고 전송 코드를 요청합니다. Aktar 앱과 연결하면 Obsidian은 키를 전혀 보지 못합니다.

연결하는 곳

추가한 대상의 저장 공간 엔드포인트와 공개 URL뿐이며, 데스크톱에서 Aktar 앱과 연결했다면 127.0.0.1의 Aktar 앱에도 연결합니다. 중간에 Aktar 서버는 없고, 계정도, 분석도, 원격 측정도 없습니다.

어떤 노트가 어떤 파일에 링크하는지 알기 위해 보관함의 파일 목록을 읽지만, 버킷으로 가는 것은 업로드하거나 옮기거나 백업한 파일뿐입니다. 클립보드는 전송 링크를 채우기 위해 Add from Aktar app을 열 때 한 번만 읽습니다.

요구 사항

  • Mac, Windows, Linux, iPhone, iPad, Android의 Obsidian 1.11.4 이상
  • Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO 또는 기타 S3 호환 서비스의 버킷(공개 URL이 있든 비공개든)
  • 선택 사항: 클릭 한 번으로 연결하려면 Mac용 Aktar 0.19 또는 Windows용 0.12 이상

질문

플러그인이 없어도 노트가 제대로 보이나요?

네. 모든 링크는 버킷을 가리키는 일반 Markdown 링크이므로, 어떤 Markdown 앱에서도, 웹에서도, Aktar 없는 Obsidian에서도 이미지가 보입니다. 플러그인이 필요한 것은 비공개 버킷에 있는 파일뿐입니다. 서명된 URL이 필요하기 때문입니다.

보관함에 있던 파일은 어떻게 되나요?

옮기면 로컬 사본은 Obsidian 휴지통으로 가며, Keep it in the vault too를 선택하면 그대로 남습니다. 어떤 노트에도 링크되지 않은 파일과 프런트매터, 코드, 캔버스에서 링크된 파일은 그대로 둡니다.

되돌릴 수 있나요?

네. 마지막 옮기기를 실행 취소하거나, 노트 하나의 파일을 되가져오거나, 링크 메뉴에서 파일을 하나씩 되가져올 수 있습니다. 파일은 버킷에서 내려오고, 링크는 다시 일반 첨부 파일 링크가 됩니다.

Obsidian Sync, iCloud, Git과 함께 쓸 수 있나요?

네. 동기화를 대신하는 것이 아니라, 동기화할 것을 작게 만듭니다. 같은 파일을 옮기는 두 기기는 같은 객체와 같은 링크를 쓰므로 서로 충돌하지 않습니다.

비용은 얼마인가요?

플러그인은 무료이며 오픈 소스입니다. 저장한 만큼 저장 공간 제공업체에 비용을 내며, Cloudflare R2는 다운로드 요금이 없습니다.

출시 소식 읽기

이 앱의 새로운 기능