fluxer.com의 계정 수가 50만 개를 넘었습니다. Fluxer 앱은 직접 운영하는 인스턴스에서도 쓸 수 있습니다.

글 읽기

내 Fluxer 인스턴스 운영하기

Fluxer는 AGPL-3.0 라이선스의 오픈 소스이며, 자체 호스팅은 무료입니다. 명령어 하나로 Linux, macOS, Windows에 내 인스턴스를 설치할 수 있습니다.

명령어 하나로 설치

curl -fsSL https://fluxer.dev/install.sh | sh

GitHub에서 스크립트 보기

irm https://fluxer.dev/install.ps1 | iex

PowerShell에서 실행하세요.GitHub에서 스크립트 보기

스크립트는 저희 GitHub 릴리스에서 rexctl을 내려받아 SHA-256 체크섬을 확인한 뒤 실행합니다. rexctl은 몇 가지 질문을 하고, HTTPS를 적용해 Fluxer를 설정한 다음, 완료되면 인스턴스 주소를 보여 줍니다.

자체 호스팅 가이드 읽기

필요한 것

  • Linux, macOS 또는 Windows가 설치된 64비트 Intel, AMD 또는 Arm 컴퓨터가 필요하며, CPU 코어 2개 이상, 메모리 4 GB 이상, 여유 디스크 공간 20 GB 이상을 갖춰야 합니다. 이 정도면 동시 접속자가 약 1,000명인 인스턴스를 운영할 수 있습니다.

  • Linux에서는 rexctl이 Docker나 Podman과 함께 작동하며, 둘 다 없으면 Docker를 자동으로 설치합니다. macOS와 Windows에서는 Docker Desktop이 설치되어 실행 중이어야 합니다.

  • 인스턴스에 쓸 도메인 또는 하위 도메인(예: chat.example.com)이 필요하며, DNS 설정에 컴퓨터의 공인 IP 주소를 가리키는 A 레코드가 있어야 합니다.

  • 컴퓨터 앞단의 모든 방화벽에서 TCP 포트 80, 443, 7881과 UDP 포트 443, 7882가 열려 있어야 합니다. 컴퓨터 자체의 방화벽은 rexctl이 ufw나 firewalld로 열 수 있습니다.

  • 이메일 서버는 없어도 됩니다. 나중에 설정하거나, 이메일 주소 없이 사용자 이름으로 로그인하게 할 수 있습니다.

전체 요구 사항 보기

GitHub에 공개된 오픈 소스

Fluxer와 rexctl의 코드는 AGPL-3.0 라이선스로 GitHub에 공개되어 있습니다. 코드를 실행하고, 연구하고, 수정하고, 공유할 수 있으며, 수정한 코드를 네트워크를 통해 다른 사람에게 제공한다면 변경 사항도 같은 라이선스로 공유해야 합니다.

라이선스 키는 필요 없고, 기능을 줄인 에디션도 없습니다. Fluxer는 Plutonium, 후원, Operator Pass로 운영비를 마련합니다.

인스턴스 운영하기

설치가 끝난 뒤에도 rexctl이 인스턴스가 계속 돌아가도록 관리합니다. 아래 명령어는 Fluxer를 설치한 컴퓨터의 터미널에서 실행하세요.

  • 업그레이드

    rexctl upgrade

    rexctl과 Fluxer를 함께 업그레이드합니다. 먼저 인스턴스를 백업하고, 새 버전이 시작되지 않으면 이전 버전으로 자동으로 되돌립니다.

    업그레이드 방식

  • 롤백

    rexctl rollback

    마지막 업그레이드 이전 버전으로 되돌리며, 데이터베이스는 그대로 유지합니다. 업그레이드 전에 rexctl이 만든 백업을 복원할 수도 있습니다.

    롤백 방식

  • 백업 및 복원

    rexctl backup

    설정, 데이터베이스, 업로드된 파일을 파일 하나에 저장합니다. 같은 컴퓨터에서 복원하거나, 인스턴스를 다른 컴퓨터로 옮기는 데 쓸 수 있습니다.

    백업 방식

  • 사용자 관리

    rexctl invites create

    초대 링크를 만듭니다. 다른 rexctl 명령어로 계정을 만들 수 있는 사람을 정하고, 대기 중인 사람을 승인하고, 관리자를 추가하고, 계정을 차단할 수 있습니다.

    사용자 관리 방법

  • 문제 확인

    rexctl doctor

    인스턴스와 컴퓨터에 문제가 있는지 확인합니다. --fix를 붙이면 rexctl이 안전하게 고칠 수 있는 문제도 고칩니다.

    모든 rexctl 명령어

  • 설정 변경

    rexctl config list

    모든 설정을 현재 값, 한 줄 설명과 함께 보여 줍니다. 이메일과 브랜딩은 관리자 패널에서도 바꿀 수 있습니다.

    설정 변경 방법

Fluxer를 운영하는 다른 방법

  • Docker Compose

    Portainer, TrueNAS, Unraid처럼 compose 스택을 대신 실행해 주는 플랫폼을 쓴다면, 모든 릴리스에 compose 번들이 함께 제공됩니다.

    Docker Compose로 운영하기

  • Kubernetes

    Helm 차트는 rexctl이 컴퓨터 한 대에서 실행하는 것과 같은 Fluxer 서비스를 Kubernetes 1.29 이상 클러스터에서 실행합니다.

    Kubernetes에서 운영하기

  • 직접 운영하는 리버스 프록시

    컴퓨터의 다른 웹 서버가 이미 포트 80과 443을 쓰고 있다면, Fluxer는 nginx, Caddy 같은 프록시를 위해 일반 HTTP로 서비스할 수 있습니다.

    내 프록시 사용하기

사용자는 Fluxer 앱으로 접속합니다

사용자는 브라우저에서 인스턴스 주소를 열거나, Fluxer 데스크톱 앱과 모바일 앱에 주소를 입력합니다. 이메일 주소와 사용자 이름 중 무엇으로 로그인할지는 내가 정하며, 내 ID 공급자를 통한 SSO 로그인도 추가할 수 있습니다.

누가 계정을 만들 수 있는지도 공개 가입, 승인, 초대 링크, 신규 계정 없음 중에서 정할 수 있습니다. 사용자는 fluxer.com을 비롯한 여러 인스턴스의 계정을 앱의 계정 전환기에 추가할 수 있습니다.

내 인스턴스와 fluxer.com

자체 호스팅 인스턴스는 저희 쪽으로 자동으로 정보를 보내지 않으며, 중앙 로그인 시스템에 의존하지도 않습니다. Fluxer 직원은 내 인스턴스에서도, 저희가 운영하지 않는 다른 어떤 인스턴스에서도 나를 차단할 수 없습니다.

내 인스턴스에는 유료 등급이 없습니다

직접 운영하는 인스턴스에는 Plutonium이 없습니다. Plutonium의 모든 혜택을 내가 무료로 누릴 수도 있고, 사용자가 혜택을 받는 방식을 직접 정할 수도 있습니다. 업로드한 파일이 만료되지 않게 할 수도 있습니다.

내 인스턴스를 위한 푸시 알림

Apple과 Google은 Fluxer만 보유한 자격 증명으로 공식 Fluxer 앱에 알림을 전달합니다. 저희 푸시 릴레이는 내 인스턴스의 알림을 Apple과 Google에 넘겨 주지만, 나와 앱 사용자가 모두 이 기능을 켠 경우에만 그렇게 합니다.

내 인스턴스가 알림을 하나하나 암호화하므로 저희는 내용을 읽을 수 없습니다. 저희는 시간이나 인스턴스의 네트워크 주소 같은 전달 정보를 기록합니다. Android에서는 UnifiedPush 버전 앱이 저희 릴레이를 거치지 않고 알림을 받습니다.

릴레이가 볼 수 있는 정보

필요한 노력

인스턴스 운영에는 꾸준한 관리가 필요합니다. Fluxer를 최신 상태로 유지하고 인스턴스가 계속 돌아가게 해야 하며, 사용자를 위한 모더레이션과 안전도 직접 책임져야 합니다.

인스턴스 관리자로서 내 인스턴스의 개인정보처리자가 되며, 개인정보처리방침 1항에 적힌 대로 개인정보 보호 법령에 따른 법적 의무를 직접 지게 됩니다.

자체 호스팅에 관한 질문

자체 호스팅은 무료인가요?

네. Fluxer와 rexctl은 무료이며, 컴퓨터와 도메인, 그 밖에 직접 사용하는 것에 드는 비용만 내면 됩니다.

자체 호스팅을 하려면 Operator Pass가 필요한가요?

아니요. 자체 호스팅, 문서, Fluxer Developers의 커뮤니티 도움은 누구나 무료로 이용할 수 있습니다. Operator Pass는 Fluxer 운영비를 보태는 선택형 일회성 구매이며, 패스가 있다고 내 인스턴스에서 새로 열리거나 달라지는 것은 없습니다.

인스턴스를 다른 컴퓨터로 옮길 수 있나요?

네. rexctl backup으로 인스턴스를 백업하고, 백업 파일을 새 컴퓨터로 복사한 다음, 그곳에서 설치 스크립트로 복원하세요. 그런 다음 도메인의 A 레코드를 새 컴퓨터의 주소로 바꾸면 됩니다.

rexctl이 나오기 전에 설치한 인스턴스는 어떻게 업그레이드하나요?

--update 옵션과 인스턴스가 있는 폴더를 지정해 최신 설치 스크립트를 실행하세요. 스크립트가 rexctl을 설치하고 인스턴스 관리를 rexctl에 넘기며, 데이터와 설정은 그대로 유지됩니다. 다시 설치할 필요는 없습니다.

나중에 rexctl 사용을 그만둘 수 있나요?

네. rexctl eject는 모든 설정을 Docker Compose용으로 인스턴스 폴더에 기록하고 rexctl이 더 이상 인스턴스를 변경하지 않게 하며, Fluxer는 계속 실행됩니다. rexctl takeover를 실행하면 인스턴스 관리를 다시 rexctl에 맡깁니다.

내 스토리지나 데이터베이스를 쓸 수 있나요?

rexctl로 설치할 때 --storage-endpoint를 사용하면 내 S3 호환 오브젝트 스토리지를 쓸 수 있습니다. Kubernetes용 Helm 차트는 이미 운영 중인 Postgres, Valkey, NATS, Meilisearch, LiveKit 서버도 사용할 수 있습니다.

Operator Pass

Operator Pass는 Fluxer를 후원하는 일회성 구매입니다. 패스에는 번호가 매겨진 Operator 인증서, Operator 배지, Operators 벽의 자리가 함께 제공됩니다. 패스로 내 인스턴스에서 바뀌는 것은 없습니다.

Fluxer 유니버스에 오신 것을 환영합니다

앱을 설치하거나 브라우저에서 Fluxer를 열고 바로 대화를 시작하세요.