본문으로 건너뛰기

서버 시작하기

공개 서버(io.iosignal.net) 대신 내 IOSignal 서버를 띄워 앱, 보드, 게임을 연결합니다. 서버는 태그만 보고 메시지를 전달하므로, 응용이 달라도 서버 설정은 같습니다. 처음이라면 핵심 개념 5분 요약을 먼저 읽으세요.

1. 설치​

Node.js 22.16.0 이상에서 둘 중 하나로 실행합니다.

방법명령언제
Node.js 코드npm install iosignal 후 new Server({ port: 7777 })앱에 서버를 넣거나, 인증·호스트를 코드로 구성할 때
CLInpm install -g iosignal-cli 후 io-server -l 7777코드 없이 바로 띄울 때

2. 첫 연결​

서버 실행에서 서버를 띄우고, 5분 빠른 시작의 수신자와 송신자로 메시지가 전달되는지 확인합니다.

3. 서버에서 정할 것​

  • 포트: 브라우저·Node.js는 WebSocket(port), Arduino는 TCP(congPort)로 붙습니다. Arduino를 받으려면 두 포트를 모두 엽니다. 연결 환경과 서버 주소
  • TLS: HTTPS 페이지에서 쓰려면 wss://가 필요합니다. 서버나 리버스 프록시에 인증서를 설정합니다.
  • 인증: 익명 연결만 받을지, 장치 키(파일·Redis·로컬 테스트 로그인)로 고정 CID를 줄지 정합니다. 같은 ID 중복 로그인 정책도 여기서 정합니다. 서버 인증 설정
  • 쿼터와 역할: 연결마다 메시지 크기, 초당 메시지·바이트, 구독자 수 한도를 정합니다. 익명 연결은 anonymousQuota를 씁니다. 서버 API: 쿼터
  • 상태 보기: dashboard: true로 실시간 상태 페이지를 켭니다. 서버 대시보드
  • 서버 안의 로직: 게임·퀴즈처럼 서버가 판정해야 하면 server.host()를 씁니다. 서버 안의 게임 로직

4. 만들기 가이드​

하고 싶은 것문서
코드나 CLI로 서버 띄우기서버 실행, CLI 서버
다른 기기·인터넷에서 접속연결 환경과 서버 주소
장치 키로 로그인 받기서버 인증 설정
실시간 상태 보기서버 대시보드
게임·퀴즈 판정게임 시작하기, 서버 안의 게임 로직
공개 서버와 주소공개 서버와 웹앱
모든 옵션과 메서드서버 API

5. 외부에 열기 전에​

  • 다른 기기에서 접속할 주소·포트·방화벽을 확인합니다.
  • HTTPS 페이지용 wss://를 준비합니다.
  • 인증과 쿼터를 설정합니다. 익명 연결도 쿼터는 항상 적용됩니다.

6. 막혔을 때​