DEVICE INBOX · GOTIFY

통신기기 수신함 사용 및 연동 안내

Gotify 서버를 연결하면 웹 콘솔에서 기기 메시지를 보내고, 통신기기의 Gotify 앱으로 알림을 받을 수 있습니다. 서버 주소와 토큰은 웹 서버 환경에 설정하며 브라우저에는 입력하지 않습니다.

발신 앱 토큰과 수신 클라이언트 토큰을 각각 설정합니다

두 토큰은 역할이 다릅니다. 앱 토큰은 푸시 전송, 클라이언트 토큰은 콘솔에서 메시지 목록을 읽는 데 사용합니다.

Gotify

통신기기에서 메시지 받기

Gotify 앱을 수신 기기에 연결합니다.

ANDROID · RECEIVER

Gotify 앱 설치

Android 기기에 Gotify 앱을 설치한 다음, 서버 주소 https://push.netcity.co.kr를 등록하고 Gotify 계정으로 로그인합니다.

Google Play에서 Gotify 앱 열기 ↗

WEB · CONSOLE

통신기기 수신함

왼쪽 메뉴의 기기 메시지함에서 제목, 내용, 우선순위를 작성해 전송합니다. 서버 메시지 목록은 대화 형식으로 표시되고 30초마다 새로고침됩니다.

기기 수신함 열기 ↗

수신과 답장은 별개입니다: Gotify 앱은 통신기기에서 알림을 받는 용도입니다. 앱 알림에서 이 웹 콘솔로 답장을 보내지는 않습니다. 기기에서 회신하려면 Gotify API에 메시지를 올리는 별도 앱이나 연동이 필요합니다.

Gotify 토큰 발급

Gotify 서버 관리 화면에서 서로 다른 종류의 토큰을 발급합니다.

전송용 앱 토큰Gotify의 Applications에서 애플리케이션을 만들고 해당 애플리케이션 토큰을 복사합니다. 이 값을 PUSH_APP_TOKEN에 설정합니다.

수신용 클라이언트 토큰Gotify의 Clients에서 클라이언트를 만들고 클라이언트 토큰을 복사합니다. 이 값을 PUSH_CLIENT_TOKEN에 설정합니다.

애플리케이션 ID애플리케이션 상세 화면의 숫자 ID입니다. 선택 항목 PUSH_APP_ID에 설정하면 콘솔이 해당 앱에서 보낸 메시지를 발신 말풍선으로 표시합니다.

앱 토큰과 클라이언트 토큰을 서로 바꿔 넣지 마세요. 토큰은 비밀번호처럼 취급하고 이 페이지, 소스 코드, 저장소, 브라우저 개발자 도구에 입력하거나 게시하지 마세요.

웹 서버 환경 변수 설정

PHP가 실행되는 Apache 또는 PHP-FPM 환경에 아래 값을 설정합니다.

PUSH_SERVER_URLGotify 서버의 HTTPS 기본 주소입니다. /message 경로는 붙이지 않습니다.

PUSH_APP_TOKENGotify 애플리케이션에서 발급한 전송용 토큰

PUSH_CLIENT_TOKENGotify 클라이언트에서 발급한 메시지 조회용 토큰

PUSH_APP_ID선택 항목. 발신 애플리케이션을 대화 목록에서 식별하는 숫자 ID

APP_USERNAME웹 메일·푸시 화면의 Basic 인증 계정

APP_PASSWORD웹 접근용 비밀번호. 16자 이상으로 설정합니다.

설정 예시

PUSH_SERVER_URL=https://push.netcity.co.kr
PUSH_APP_TOKEN=Gotify_애플리케이션_토큰
PUSH_CLIENT_TOKEN=Gotify_클라이언트_토큰
PUSH_APP_ID=애플리케이션_ID
APP_USERNAME=웹접근_계정
APP_PASSWORD=16자_이상의_비밀번호

위 값은 형식 예시입니다. 실제 비밀 값은 웹 공개 폴더 밖의 서버 환경 변수 관리 기능에 저장하세요. 변경 후 PHP-FPM 또는 Apache를 재시작해야 적용됩니다.

서버 URL은 HTTPS여야 하고, PHP 서버에서 Gotify 주소로 연결할 수 있어야 합니다. 이 사이트의 연결 상태 점검은 설정 유무만 확인하며 토큰 값을 표시하지 않습니다.

보내기와 수신 확인

환경 변수를 적용한 뒤 실제 기기에서 종단 간으로 확인합니다.

설정 점검: 푸시 연결 상태 점검에서 누락된 환경 변수와 보안 로그인 설정을 확인합니다.
수신 앱 로그인: Android Gotify 앱에 서버 주소를 등록하고 계정에 로그인합니다.
테스트 전송: 기기 메시지함에서 테스트 제목과 메시지를 보내고 수신 기기에 알림이 도착하는지 확인합니다.
대화 목록 확인: 전송한 항목은 발신 앱 ID가 설정되어 있으면 보낸 메시지로 표시됩니다. 클라이언트 토큰이 읽을 수 있는 다른 Gotify 메시지도 목록에서 확인할 수 있습니다.

수신 목록은 Gotify 서버에 저장된 메시지 피드를 보여줍니다. 이 화면의 “받기”는 문자나 이메일 수신을 뜻하지 않으며, Gotify 서버에 메시지를 올리는 송신 주체가 있어야 목록에 나타납니다.

연결 문제 해결

오류 메시지와 환경 변수 역할을 먼저 확인하세요.

설정 누락 표시환경 변수 이름과 PHP 실행 계정의 적용 여부를 확인한 뒤 웹 서버 프로세스를 재시작합니다.

401 또는 403전송에는 애플리케이션 토큰, 목록 조회에는 클라이언트 토큰을 사용했는지 확인하고 토큰을 재발급합니다.

연결 또는 TLS 오류서버에서 Gotify 주소에 접속할 수 있는지, HTTPS 인증서가 유효한지, 방화벽에서 연결을 막지 않는지 확인합니다.

목록에 메시지가 없음같은 Gotify 서버에 메시지가 전송되었는지와 클라이언트 토큰의 계정·권한을 확인합니다. 푸시 알림 자체와 서버 메시지 보관은 별개입니다.

기기 수신함 열기 메일 서버 연결 안내