matrix에 텔레그램 브릿지 붙이기
1. 브릿지란?
저도 모릅니다. 이거 연결하면 텔레그램에 있는 메세지를 전부 matrix로 받아볼 수 있는 것만 알아요. 움직이는 거 보니까 일종의 외부 접속 어플리케이션으로 인식하는 거 같더라고요.
2. 사용하려면?
일단 matrix-telegram 사이를 연결해주는 브릿지 서버(깃헙)를 올리던가 남이 만들어둔 브릿지 봇을 써야합니다. 남이 만들어둔 브릿지 봇은 여기서 참고(링크)
3. 브릿지 서버를 올려보아요.
저는 브릿지 서버를 올리는 방법을 기록할 거예요. 공식 가이드(설치, 도커)참고하면 되는데 이거 진짜 설정 복잡합니다.
이게 깃헙에 올라가있는 예시 링크인데 길이 보세요. (링크)
차근차근 갑시다. 도커 컴포즈 기준이에요.
homeserver:
address: [https://실제 서비스 주소]
domain: [핸들 주소]
verify_ssl: true
http_retry_cont: 4
status_endpoint: [비워두세요]
message_send_checkpoint_endpoint: [비워두세요]
async_media: false
대부분의 값은 디폴트 값으로 뒀으니 주석 참고하세요.
appservice:
address: [http://도커로 올린 브릿지 서버 이름:29317]
tls_cert: false
tls_key: false
hostname: 0.0.0.0
port: 29317
max_body_size: 1
public:
enabled: false
prefix: /public
external: [http://실제 서비스 주소/public]
provisioning:
enabled: true
prefix: /_matrix/provision
shared_secret: [자동생성]
id: telegram
bot_username: telegrambot
bot_displayname: Telegram bridge bot
bot_avatar: mxc://maunium.net/tJCRmUyJDsgRNgqhOgoiHWbX
ephemeral_events: true
as_token: [자동생성]
hs_token: [자동생성]
metrics, manhole 설정은 건드리지 않았습니다.
bridge:
...
double_puppet_server_map:
[핸들 주소]: [https://실제 서비스 주소]
double_puppet_allow_discovery: false
login_shared_secret_map:
[핸들 주소]: as_token:[자유 랜덤 문자열]
double puppeting은 주석에도 설명이 있지만, 텔레그램에서 올라온 내 글과 매트릭스에서 올라온 내 글을 모두 볼 수 있게 해주는 거예요. 그 뒷부분도 저는 기존 예시대로 유지했습니다.
그 다음으로 중요한 부분은 bridge안에 있는 encryption 설정입니다.
...
permissions:
[유저/서버]: [권한]
유저/서버 '*' : 모든 매트릭스 유저 '도메인': 특정 서버의 모든 유저 '유저 핸들': 사용할 수 있는 유저
권한 'relaybot': 커맨드는 사용할 수 없고 브릿지 연결로만 사용할 수 있는 권한 'user': relaybot 권한에 브릿지를 만들 수 있는 접속 명령 사용 가능 'puppeting': user 권한에 텔레그램 계정에 로그인 할 수 있는 권한 'full': 브릿지 봇의 모든 권한 사용 가능. matrix 로그인 가능 'admin': 브릿지 봇의 모든 권한 및 관리 명령어 사용 가능
써두긴 했는데 정확한 건 설정 예시 참조해주세요.
relaybot:
...
whitelist:
- [유저명]
봇 명령을 사용할 수 있는 유저 목록
telegram:
api_id: [https://my.telegram.org/apps에서 얻은 api_id]
api_hash: [https://my.telegram.org/apps에서 얻은 api_hash]
bot_token: [https://t.me/BotFather를 통해 얻은 봇 토큰]
...
device_info:
device_model: [도커 컴포즈에서 설정한 브릿지 서버 이름]
* 경고 이 바로 아래 있는
server:
enabled: false
는 반드시 false로 유지해야합니다. 한 번이라도 true로 바꾸면 데이터베이스를 갈아엎어야해요. 저는 데이터베이스 필요없다는 걸 깨닫고 해제해서 해결함.
4. 이제는 matrix 서버에 연결할 차례
여기까지 진행했으면 브릿지 서버에는 큰 문제가 없을 거예요.
그 다음은 homeserver.yaml입니다.
app_service_config_files:
- /data/matrix-telegram/registration.yaml
- /data/matrix-telegram/doublepuppet.yaml
일단 여기에 이렇게 설정을 추가해주고, registration.yaml은 자동으로 생기는 거니 건드리지 않으면 됩니다. doublepuppet.yaml은 이 페이지를 참고해주세요.
id: doublepuppet
url:
as_token: [아래 설명]
hs_token: [안 쓰이는 거니까 아무거나 넣으세요]
sender_localpart: [적당히 아무거나]
rate_limited: false
namespaces:
users:
- regex: '@.*:내\.도메인'
exclusive: false
as_token은 bridge 설정 안에 있는
login_shared_secret_map:
[핸들 주소]: as_token:[자유 랜덤 문자열]
의 as_token 뒤의 문자열을 넣으면 됩니다.
5. 끝!
정보가 부족한 부분이 있거나 잘못된 부분이 있으면 mastodon로 연락주세요.
배너
matrix 서버에 마스토돈 로그인 추가하기
공식 가이드대로 하면 됩니다. ...만, 주의사항.
공식 가이드에서 제공하는 설정에는 함정이 있습니다.
localpart_template: "{{ user.username }}
이 설정은 마스토돈 유저의 핸들을 그대로 활용하여 로그인하게 하는 방법입니다. 여기서 문제가 생기는 게 무어냐, oidc를 활용한 가입을 열어두었을 경우 같은 아이디가 있으면 자동으로 id 뒤에 숫자가 붙어 중복 가입을 시켜버립니다.
반대로 oidc를 활용한 가입을 닫아두었을 경우 로그인이 불가합니다. allow_existing_users 옵션을 켜두었을 경우 같은 아이디를 가진 유저로 바로 로그인이 됩니다. 즉, 다른 유저로 인증 없이 로그인이 가능합니다.
그래서 localpart_template를 없애보았는데 이번엔 비밀번호로 이미 가입한 계정에 연동하는 게 안 되더라고요. 덕분에 비밀번호 가입과 oidc를 동시 연동하겠다는 꿈이 깨졌습니다... ㅇ_ㅠ...
만져보니 db를 직접 건드리거나 이리저리 꼼수를 쓰면 어떻게 가능할 것 같긴 한데 추천하진 않습니다.
결론: 비밀번호 가입과 마스토돈 가입을 동시에 열어두면 로그인이 꼬인다.
참고로 기본 메뉴얼에도 있는 정보지만 enable_registration를 켜두면 비밀번호 가입과 별도로 해당 oidc로 회원가입 여부를 결정할 수 있습니다.
배너
docker로 TURN서버 올려서 matrix 서버에서 음성, 화상 채팅 기능 활성화하기
matrix 클라이언트에서 보면 음성, 화상 채팅 기능이 있다. 그런데 서버를 올리고 보니 기능이 없어서 그게 안 되더라. 알아보니 VoIP를 통해 통신을 해야하고 그걸 해주는 TURN 서버를 붙여야한다고...
해서, 붙여봤습니다.
TURN 서버는 coturn으로 올렸습니다. 공식 가이드에 따르면 apt로 설치해서 돌리는 건데 저는 굳이 docker로 올렸어요. 다행히 coturn 공식에서 제공하는 docker compose 문서가 친절해서 금방 설치할 수 있었습니다.
위 docker-compose.yml 문서와 관련한 주의점.
- postgres로 되어있지만 DB는 필요 없었어요.
- 80, 443 포트는 삭제해주세요.
- 문서에 적혀있는 포트는 다 개방해줘야합니다.
마지막으로 turnserver.conf는 coturn에서 제공하는 공식 예시와 matrix에서 제공하는 안내 문서가 있습니다. 저는 cotrun에서 제공하는 공식 예시를 보고 작성했어요.
turnserver.conf
listening-port=3478
tls-listening-port=5349
여기까진 기본 설정입니다.
listening-ip=
external-ip=[서버 아이피]
listening-ip는 비워두면 모든 ip에서 수신합니다. external-ip는 서버 외부 ip예요. 이쪽으로 오면 된다고 알려주는 겁니다.
static-auth-secret=[비밀 키]
server-name=[TURN 서버명]
realm=[TURN 서버 도메인]
여기는 써있는대로.
cert=[cert.pem 경로]
pkey=[private key 경로]
이건 openssl로 만들었어요.
openssl req -newkey rsa:2048 -new -nodes -x509 -days 3650 -keyout key.pem -out cert.pem
syslog
simple-log
로그 설정. 저는 file에다 지정했는데 바꾸려고요.
나머지는 matrix 문서에서 하라는 대로 하면 됩니다. 저는 coturn 문서 보고 하는 바람에 오히려 헷갈린 게 많긴 했어요. 워낙 옵션이 많아서...
homeserver.yaml
turn_uris: [ "turn:[TURN 서버 도메인]?transport=udp", "turn:[TURN 서버 도메인]?transport=tcp" ]
turn_shared_secret: "turnserver.conf에서 static-auth-secret에 넣은 비밀 키"
turn_user_lifetime: 86400000
turn_allow_guests: true
이건 사실 matrix 공식 가이드대로 하기만 하면 돼서 쓰기 뭐한데... 그렇습니다.
이거면 설정 끝! 자료도 많고 가이드도 잘 되어있어서 꽤 쉬웠어요. 오히려 자료가 너무 많아서 좀 헤맸습니다. turnserver.conf 설정은 matrix 가이드 따라하세요. 저처럼 coturn 설정 보고 다 챙기려다 실패하지 말고.
배너
docker를 이용해 matrix(연합 채팅 프로토콜) 서버 올리기
준비물
- 서버를 올릴 컴퓨팅 자원
필요한 프로그램
- docker와 docker compose
- nginx
- 문서 편집기
1. docker-compose.yml 만들기
원하는 경로에 matrix 폴더를 만들고 그 안에 docker-compose.yml을 만들어 다음 내용을 작성한다. 폴더는 따로 안 만들어도 동작 하지만 나는 matrix용 폴더를 만들고 그 안에 docker 볼륨이 들어갈 폴더를 만들었다.
services:
synapse:
image: matrixdotorg/synapse
restart: always
ports:
- 8008:8008
volumes:
- [볼륨을 물릴 경로]:/data
2. 도메인 물려서 서버 동작시키기
docker run -it --rm -v [볼륨을 물릴 경로]:/data -e SYNAPSE_SERVER_NAME=[서버를 돌릴 도메인 주소] -e SYNAPSE_REPORT_STATS=yes matrixdotorg/synapse:latest generate
동작시키면 [볼륨을 물릴 경로]에 homeserver.yaml 파일이 생긴다. 이 파일에서 가입을 열고 다른 설정을 할 수 있다.
위 명령어가 잘 동작했다면 서버의 8008 포트에 접속해본다.
위와 같은 화면이 뜨면 성공적으로 올라간 것이다.
3. nginx에 서버 물려서 서비스하기
nginx는 설치되어 있다는 가정 하에, /etc/nginx/sites-available/ 경로에 매트릭스를 위한 config파일을 하나 만든다. 파일명은 알아만 볼 수 있으면 된다.
기본적인 내용은 다음과 같다
server {
server_name [서버를 돌릴 도메인 주소];
location ~ ^(/_matrix|/_synapse/client) {
proxy_pass http://localhost:8008;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $host;
client_max_body_size 50M;
proxy_http_version 1.1;
}
}
위 내용으로 config 파일을 만들었다면
ln -s /etc/nginx/sites-available/[설정파일명] /etc/nginx/sites-enabled/[설정파일명]
을 수행한 후 nginx -t 명령으로 설정에 문제가 없는지 확인한다.
systemctl restart nginx nginx를 재시작한다.
nginx가 제대로 돌아가려면 방화벽에서 80번 포트와 443 포트가 열려있어야 한다. 그걸 위해 아래 명령을 수행하거나 또는 다른 툴을 이용해 방화벽을 열어준다.
ufw allow 'Nginx Full'
4. 인증서 발급
certbot을 이용해 인증서를 발급받는다. 이 과정 설명은 생략한다.
인증서를 발급받으면 방금 설정한 nginx 설정 아래쪽에 listen 443 ssl; # managed by Certbot로 시작하는 코드가 몇 줄 생겼을 것이다. 그 위에 listen 8448 ssl;를 추가해준다.
기존의 location과 listen ... 사이에 다음 코드를 추가해준다.
location /.well-known/matrix/client {
return 200 '{"m.server": {"base_url": "[서비스할 도메인 주소]:443"}}';
default_type application/json;
add_header Access-Control-Allow-Origin *;
}
location /.well-known/matrix/server {
default_type application/json;
add_header Access-Control-Allow-Origin *;
return 200 '{"m.server":"[서비스할 도메인 주소]:443"}';
}
3.5 만약 실제 서비스는 서브 도메인으로, 계정 핸들은 메인 도메인으로 사용하고 싶다면
바로 위의 /.well-known/... 설정은 메인 도메인 nginx 설정에 넣어준다. 코드 내부에 넣을 주소는 실제 서비스가 돌아가고 있는 서브도메인 주소를 넣으면 된다.
[볼륨을 물릴 경로] 내부의 파일을 다 지운다. 그 후 docker compose down을 이용해 서버를 내리고
docker run -it --rm -v [볼륨을 물릴 경로]:/data -e SYNAPSE_SERVER_NAME=[핸들로 사용할 도메인] -e SYNAPSE_REPORT_STATS=yes matrixdotorg/synapse:latest generate
위 명령어를 실행한다.
4. 가입 열기
[볼륨을 물릴 경로]/homeserver.yaml을 열어 enable_registration: true를 추가한다.
이후 docker compose를 올리면 되는데...
내가 해봤을 때 뭔가 설정을 추가해달라는 요구가 뜨며 오류가 났었다. 정확히 무슨 옵션을 추가하라고 했었는지는 기억이 나지 않으니 docker compose up 명령어를 이용해 직접 확인해서 추가하면 된다. 모든 옵션 설정이 끝나면
docker compose up -d
로 서버를 백그라운드에 올려서 완료.
5. 오브젝트 스토리지
여기서 끝인 줄 알았는데 object storage를 연결해야한다는 걸 알게됐다. 버킷 없이 관리할 수도 있지만 자신이 없어서 물려놓기로 했다. 문제는 직접 설치한 게 아니라 도커로 서버를 올렸다는 것.
직접 설치했을 경우 matrix.org에서 제공하는 synapse-s3-storage-provider를 이용할 수 있으나 도커로 올리면 방법이 없다.
검색을 반복한 끝에 [볼륨을 물릴 경로]/media_store에 rclone으로 오브젝트 스토리지를 mount 하기로 했다. 각자의 object storage의 특성에 맞춰 mount해서 사용하면 된다. media_store는 기본 설정이므로 homeserver.yaml파일에서 설정을 바꿀 수 있다.
6. 도움이 되는 사이트
7. 참조
https://theselfhostingblog.com/posts/self-hosting-your-own-matrix-server-on-a-raspberry-pi/ https://matrix-org.github.io/synapse/latest/
배너
요즘 연합우주에 유행한 matrix 서버 올리기
https://theselfhostingblog.com/posts/self-hosting-your-own-matrix-server-on-a-raspberry-pi/
이 글 보고 그대로 따라했습니다만,
서브 도메인 떼는 부분은 대충 읽고(뭐에 정신이 팔린 거지?) 그대로 넣었네요. 왜 그랬지?? 여튼 조만간 정리 한 번 해서 이쪽에도 올려둘 예정.
배너
오늘도 하나 배웠다.
글쓰기라는 여정
오늘 오랜만에 소설책을 완독했다. 성에 차는 책은 아니었지만, 분명 좋은 책이었고, 나름 재밌게 읽었다. 요즘 세상은 힐링이 되는 이야기를 좋아하는 것 같다.
다 읽고 나서 제일 먼저 든 생각은 내가 소설을 쓰고 싶었던 게 아닐지도 모른다는 거였다. 그래서 방금 곰곰 생각해봤는데 맞는 거 같다. 나는 단순히 나와 마주보는 거울 같은 글을 쓰고 싶었다. 그러기에 소설은 너무 돌아가는 길이고, 당연히 현재의 나와 마주보는 일에서는 거리가 멀었다. 그래서... 내가 소설을 쓰지 못했던 걸지도 모른다. 아니, 그렇구나 하는 깨달음이다.
나는 나와 마주보는 글을 쓰고 싶다. 결국 내게 필요한 건 일기였던 건지도 모른다. 일기는 꾸준히 쓸 수 있었다. 하지만 이걸 누군가에게 보여주고 싶은 마음도 있다. 무얼 어떻게 해야할까. 에세이는 내 체질이 아닌 것 같은데. 연구가 필요한 시점인지도 모르겠다.
그래도 소설이 쓰고 싶기는 하다. 다만 이제는 좀 더 즐길 거리로, 취미로 즐기고 싶다. 좀 더 즐겁게 여행을 떠나고 싶다. 그래, 소설은 여행이다. 나는 여행을 떠나기보다 제자리에서 일상을 살아가고 있었다. 그러니 아무것도 쓰지 못 했다.
사랑하는 나의 이야기들아, 언젠가 우리 마주할 날이 있을거야. 그때까지 함께 있자.
배너
writefreely 연합우주 아이콘 바꿀 수 있는 방법 고민
현재 대안으로 나온 게 세 가지 정도.
- 블로그 커스터마이즈 내부 항목인 포스트 시그니처에 이미지를 넣으면 거기서 url을 따와서 넣기
- 블로그 커스터마이즈 내부 항목에 프로필 사진 넣는 파트를 만들어서 넣기(DB에 열 추가)
- 연합우주 계정에서 프로필 따오기
현실적으로 1번이 가장 가능성이 높기는 하다.
일단은 각 알파벳/숫자로 되어있는 아이콘을 좀 예쁘게 고쳐보는 걸로...
배너
성인 ADHD 확진을 받다
처음 ADHD를 의심한 건, 아마도 작년 겨울? 쯤이었던 거 같다. 올해 초일 수도 있고.
정확한 시기는 기억 안 나지만 어쨌든 굉장히 우울증이 심하던 때였다. 죽으려고 목에다 날카로운 가위를 들이대고 한참 숨을 골랐던 기억이 있다. 살면서 죽고 싶다고 생각하지 않았던 시기는 없지만, 그 때처럼 이러다 죽을지도 모른다는 생각이 강렬하게 들었던 적도 없었다.
뭐가 계기였는진 모르겠으나 정확히 ADHD를 처음 의심한 건 정확히 그 시기였다. 내 우울의 근원이 여기라는, 확신할 순 없지만 너무나도 강렬한 예감이 들었다. 우울이 워낙 심한 시기여서 진단은 받을 수 없었다. 응급상황이라고 입원하란 권유까지 받았으니까.
기존 병원에서는 검사를 거부하고, 새롭게 예약을 하려니 몇 달을 기다려야하는 상황. 당장 상황을 해결하고 싶었던 나는 조바심에 의사의 조언을 잘 따르고 있음에도 불구하고 심적인 고생이 심했다. 물론, 그렇게 해서 우울증은 좀 나아지긴 했습니다.
그러다가 이사를 하고, 이사하면서 병원을 옮겼는데 의사가 내가 고민하고 있는 걸 듣더니 단호하게 '어렸을 때 공부 잘했으면 ADHD 아니에요.'라고 말했더랬다. 그래서 이렇게 나아졌는데도 아니라고 하는 거 보니 정말 아닌가보다, 하고 마음을 털었다.
그렇게 시간이 흘러 2024년 초. 지인이 ADHD 약을 먹다가 사정이 생겨서 약이 줄어들었고, 그걸 회복하는 과정을 실시간으로 듣게 됐다. 근데 중간에 상태 안 좋을 때 상황이 나랑 너무 비슷한 거야? 배가 충분히 부른데도 계속 뭔가 먹는다거나... 이것만은 아닌데 정확히 기억이 안 난다. 하여간 이 일 덕분에 다시 의심이 고개를 들었고, 나는 한참 SNS에서 이걸 떠들었다.(4월)
ADHD에 관련해서 여러 사람이 여러 답을 주었고, 그걸 다 듣고 나서도 역시 나는 ADHD가 맞는 거 같다는 확신이 들어서 병원 3군데다 검진 예약을 잡았다. 왜냐면 하나는 5월, 하나는 6월, 하나는 10월이었거든... 조금이라도 빨리 받고 싶어서 여기저기 연락했다.
그러다가 4월 12일. 병원 예약을 잡아둔 상태라 가서 이야기를 했다. (약 조절을 하는 중이라 2주 간격이었다.) 처음에는 약간 비웃는 듯이 반응하던 의사가(기분 좀 나빴는데 그냥 이 사람 특성인 것 같다.) 내가 다른 병원에 예약을 잡아놨다고 하니까 반응이 바뀌더라. 여기서도 할 수 있고 당장도 할 수 있대서 그럼 바로 받겠다고 하고 곧장 병원에서 검진을 받았다.
그대로 확진 ^^)... 약의 도움을 받아보겠냐고 질문하길래 그러겠다고 대답하고 콘서타를 받아왔다. 그리고 오늘이다. 여러모로 받아오길 잘했다고 생각한다. 내가 생각보다 앉아서 많이 꼼지락거린다는 사실도 알 게 됐고, 집중하려고 하면 주변의 이야기가 흘러나가는 느낌도 오랜만에 돌아왔고(어릴 때는 아예 안 들리기도 했다.). 식욕도 아주 약간은 줄었다가 돌아왔다. 부작용이긴 하지만 나한텐 필요한 부작용.
연합우주에 콘서타 먹고 느끼는 변화를 적고 있다. *링크 무엇보다 퍼포먼스가 확연히 증가해서 집안일도 조금씩 해치우고 있고, 공부도 된다. 행복해. 단지 문제라면 사람 만나서 하는 행동이 너무 주책없어졌다는 건데... 미래의 내가 해결하길 바란다. 힘내, 나.
부작용도 적고 긍정적으로 작용하고 있으니 다음에 가면 좀 늘려달라고 부탁해볼 예정이다.
배너