원문 캡처 · blog.maartenballiauw.be
원문 캡처 · blog.maartenballiauw.be

서버를 직접 운영하지 않아도 웹핑거(WebFinger) 정보를 내 도메인에서 제공하면 마스토돈 계정을 그 도메인 주소로 찾을 수 있다. 계정은 기존 서버에 그대로 두면서 서버를 옮겨도 계속 사용할 발견용 주소를 만드는 방법이다.

2026년 10월 업데이트: 2022년 이후 마스토돈과 각 인스턴스가 바뀌어 화면과 설명이 현재와 다를 수 있지만, 웹핑거 방식은 동일하게 작동한다.

마스토돈은 여러 서버의 커뮤니티가 서로 연합해 더 넓은 소셜 네트워크를 이루는 서비스다. 서버 목록에서 가입할 곳을 고르거나, 직접 서버를 운영하거나, 호스팅 서비스를 이용할 수 있다.

자체 서버를 운영하면 내 도메인으로 계정을 만들고 데이터를 직접 관리할 수 있다. 하지만 서버 운영을 맡기면서도 사람들이 쉽게 찾을 수 있는, 서버를 바꾼 뒤에도 유지할 주소를 원한다면 도메인에서 웹핑거 조회에 응답하는 방법이 있다. 계정 자체는 가입한 마스토돈 서버에 남는다.

내 도메인으로 계정 찾기

마스토돈은 서버 간 통신에 ActivityPub을 사용하고, 계정 같은 액터를 찾을 때 웹핑거를 이용한다. 웹핑거는 서버의 /.well-known/webfinger 경로에서 동작한다. 마스토돈은 다음과 같은 요청으로 계정을 조회한다.

GET /.well-known/webfinger?resource=acct:accountname@server

기존 서버에서 내 계정을 조회하면 계정 정보가 담긴 JSON을 받을 수 있다. 원문에 나온 응답은 다음과 같다.

GET https://mastodon.online/.well-known/webfinger?resource=acct:[email protected]

{
 "subject": "acct:[email protected]",
 "aliases": [
 "https://mastodon.online/@maartenballiauw",
 "https://mastodon.online/users/maartenballiauw"
 ],
 "links": [
 {
 "rel": "http://webfinger.net/rel/profile-page",
 "type": "text/html",
 "href": "https://mastodon.online/@maartenballiauw"
 },
 {
 "rel": "self",
 "type": "application/activity+json",
 "href": "https://mastodon.online/users/maartenballiauw"
 },
 {
 "rel": "http://ostatus.org/schema/1.0/subscribe",
 "template": "https://mastodon.online/authorize_interaction?uri={uri}"
 }
 ]
}

이 JSON을 내 도메인의 /.well-known/webfinger 경로에서 제공하면 된다. 원문에서는 기존 서버에서 받은 응답을 도메인 서버에 복사해 이 방식이 작동했다고 설명한다.

  • https://<your mastodon server>/.well-known/webfinger?resource=acct:<your account>@<your mastodon server>에서 JSON을 받아 저장한다.
  • JSON을 https://<your domain>/.well-known/webfinger에서 제공한다.
  • 마스토돈에서 @<anything>@<your domain>을 검색해 기존 서버의 계정으로 연결되는지 확인한다.

주의할 점은 이 방식이 모든 계정 이름에 응답하는 포괄 주소처럼 작동한다는 것이다. 원문은 별도의 스크립트를 추가해 공개할 리소스만 결과에 표시하도록 제한할 수 있다고 설명한다.

자체 마스토돈 서버를 운영할 때 사용하는 LOCAL_DOMAIN과 WEB_DOMAIN 설정은 이 방법과 다르다. 설정 문서의 분할 도메인 구성에서는 LOCAL_DOMAIN을 example.com, WEB_DOMAIN을 mastodon.example.com으로 설정한다. 그러면 서버는 mastodon.example.com에서 운영되면서 @[email protected] 주소를 제공한다. 이 구성에서는 https://example.com/.well-known/webfinger가 CORS 헤더와 함께 mastodon.example.com의 같은 경로로 리디렉션되어야 한다. 반면 여기서 소개한 방법은 다른 사람이 서버를 운영하고, 내 도메인은 계정 JSON을 복사해 웹핑거 조회에 응답한다.

원문은 트위터에서 마스토돈 계정을 찾는 도구로 Twitodon, Fedifinder, Debirdify도 소개한다. Twitodon은 서비스를 이용하는 사람들의 정보를 바탕으로 트위터 계정과 마스토돈 계정을 연결하고, 나머지 두 도구는 트위터 계정 프로필에서 마스토돈 계정 정보를 찾는다.

글에는 사용자 지정 도메인 지원을 요청한 마스토돈 깃허브 이슈와 Jekyll 사이트에 적용한 사례를 보여주는 제프 핸들리의 변경 내역도 담겼다. 2022년 11월 15일 수정 내용은 CloudFlare 같은 프록시 설정을 통해 다른 도메인에서 웹핑거를 제공하는 사례가 있다고 전한다. 11월 16일 수정 내용은 로그아웃 상태에서는 사용자 지정 별칭이 검색되지 않을 수 있다고 덧붙였다.