마스토돈 운영

한국 마스토돈 연합위키
둘러보기로 이동 검색으로 이동

나만의 마스토돈 서버를 만들고 운영해봅시다.

서버 만들기[편집]

마스토돈 서버를 만드려면 크게 두 가지 선택지가 있습니다.

운영하기[편집]

아직 내용이 없습니다


유용한 명령어들[편집]

운영을 하면서 유용하게 쓰이는 명령어들을 정리합니다.

주기적(1달에 한 번)으로 돌려주면 좋은 명령들:

  • tootctl statuses remove
  • tootctl media remove --days=30
  • tootctl accounts cull -c 20


tootctl cache clear[편집]

마스토돈 버전을 업그레이드 한 후, 올바르지 않은 캐시가 있을 수 있기 때문에 반드시 돌려주어야 하는 명령입니다.


tootctl cache recount[편집]

마스토돈은 사용자의 게시물 수, 게시물의 부스트 수 같은 값을 빠른 응답을 위해 미리 계산해 캐시에 담아놓고 사용합니다. 오래된 서버의 경우 이 값이 맞지 않을 수 있기 때문에 한 번 돌려주면 카운트를 다시 계산해 값이 맞게 됩니다.


tootctl search deploy[편집]

마스토돈에 ES를 통한 텍스트 검색 기능을 새로 붙인 경우, 이 명령을 통해 기존 게시물들에 대한 인덱스를 생성할 수 있습니다. ES 데이터베이스가 깨져서 새로 생성한 경우에도 유용합니다. 주기적으로 돌려줄 필요는 없습니다.


tootctl media remove[편집]

마스토돈은 원격 서버의 미디어를 자신의 오브젝트 스토리지에 복사하여 저장해 로컬 사용자에게 제공합니다. 오래된 이미지들은 굳이 가지고 있을 필요가 없으므로 주기적으로 이 명령을 통해 제거할 수 있습니다. 만약 사용자가 다시 해당 원격 미디어를 요청한다면 그 때 다시 다운로드하여 제공하므로 안심해도 됩니다.

사용법 예시: tootctl media remove --days=30


tootctl preview_cards remove[편집]

서버에 생성된 링크 미리보기 카드 중 오랫동안 사용되지 않은 미리보기 카드를 삭제합니다. 다시 링크를 포함한 게시물이 생성된 경우 다시 미리보기 카드를 생성하기 때문에 안심해도 됩니다.

사용법 예시: tootctl preview_cards remove --days=180


tootctl statuses remove[편집]

로컬에 저장된 원격 게시물들 중에서 이젠 더이상 사용자가 팔로우 하지 않는 유저의 글 등, 더이상 존재할 필요가 없는 게시물들을 찾아 지워줍니다.

사용법 예시: tootctl statuses remove


tootctl accounts cull[편집]

연합이 잘 되지 않는 경우 가끔 삭제된 사용자가 로컬 데이터베이스에는 남아 있는 경우가 있습니다. 이때 accounts cull 명령으로 사용자가 실제로 존재하는지 다시 확인하여 404, 410이 반환되는 경우 데이터베이스에서 삭제합니다.

사용법 예시: tootctl accounts cull -c 20


tootctl domains purge[편집]

어떤 서버가 self-destruct 같은 명령을 사용하지 않고 그냥 연합우주에서 사라져 버린 경우, 해당 서버에서 작성된 게시물들은 로컬 서버에서 삭제되지 않습니다. 해당 서버의 모든 정보를 데이터베이스에서 삭제할 수 있습니다. 주의: 해당 서버가 정말로 완전히 삭제된 것인지 확인하세요. 그냥 잠시 다운되었을 경우엔 돌리지 않는 것이 좋습니다.

사용법 예시: tootctl domains purge [domains...]


tootctl self-destruct[편집]

마스토돈 운영을 그만두고 싶을 때 모든 사용자를 삭제한다는 ActivityPub 메시지를 만들어 현재까지 만났던 모든 서버에게 전달합니다. 이 과정을 거치지 않고 운영을 종료하면 다른 서버들에는 로컬 유저의 기록이 남아 있기 때문에 운영을 종료하기 전엔 반드시 돌려주는 것을 권장합니다.

주의 이 명령은 되돌릴 수 없습니다. 명령을 실행할 때 확인하는 과정이 들어있긴 하지만 절대로 운영 중인 서버에서 실험적으로 실행하지 마세요.