서버 시작하기
공개 서버(io.iosignal.net) 대신 내 IOSignal 서버를 띄워 앱, 보드, 게임을 연결합니다. 서버는 태그만 보고 메시지를 전달하므로, 응용이 달라도 서버 설정은 같습니다. 처음이라면 핵심 개념 5분 요약을 먼저 읽으세요.
1. 설치
Node.js 22.16.0 이상에서 둘 중 하나로 실행합니다.
| 방법 | 명령 | 언제 |
|---|---|---|
| Node.js 코드 | npm install iosignal 후 new Server({ port: 7777 }) | 앱에 서버를 넣거나, 인증·호스트를 코드로 구성할 때 |
| CLI | npm 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://를 준비합니다. - 인증과 쿼터를 설정합니다. 익명 연결도 쿼터는 항상 적용됩니다.