RIDM Apps 앱 호스팅
깃흐름으로 코드를 올릴 때마다 빌드·배포하고 <이름>.ridm.ai 주소로 공개해요(깃허브도 사용가능). 깃허브 계정이 없어도 컴퓨터에 깃흐름 프로그램만 깔면 AI가 저장하고 올려요. 앱마다 전용 PostgreSQL DB가 붙어서 회원·글·기록을 바로 저장할 수 있어요. 사주 API로 만든 앱도, API를 쓰지 않는 일반 웹앱도 올릴 수 있어요.
배포는 네 단계
- 신청 — 콘솔의 내 앱에서 플랜과 주소(서브도메인)를 골라요.
- 깃흐름 연결 — 앱 화면에서 「깃허브 연결 없이 시작하기」를 고르고, 컴퓨터에 깃흐름 프로그램을 깔아
hrum login으로 연결해요. (깃허브도 사용가능: GitHub Appridm-apps-builder를 설치하고 저장소와 브랜치를 골라요. 권한은 저장소 읽기뿐이에요.) - 올리기 —
hrum push로 올릴 때마다(깃허브는 연결한 브랜치에 푸시할 때마다) 빌드가 시작되고, 빌드 기록과 실패 로그는 앱 화면에 표시돼요. - 공개 — 빌드가 성공하면 자동 검사를 거쳐 바로 공개돼요. 첫 배포가 공개되기 전에는 유료 요금이 차감되지 않아요.
HTML·CSS·JS만 있는 정적 사이트도 컨테이너(Dockerfile)로 올려요. 파일을 public/에 두고 저장소 루트에 아래 Dockerfile을 넣으면 돼요. 포트 3000, 사용자 1000 같은 조건은 배포 가이드에 있어요.
FROM busybox:1.36
COPY --chown=1000:1000 public /www
USER 1000:1000
EXPOSE 3000
CMD ["httpd", "-f", "-p", "3000", "-h", "/www"]
큰 3D·이미지 정적 사이트 올리기
three.js 게임처럼 모델(.glb)·텍스처가 수십 MB인 사이트는 busybox 대신 nginx:alpine으로 올려요. busybox httpd는 캐시 헤더를 정할 수 없고 .glb·.ktx2를 일반 파일 형식으로 보내요. 아래 두 파일을 저장소 루트에 두면 빌드 결과(Vite 기준 dist/)를 그대로 서비스해요.
# Dockerfile
FROM node:22-alpine AS build
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
RUN npm run build
FROM nginx:1.27-alpine
COPY nginx.conf /etc/nginx/nginx.conf
COPY --from=build --chown=1000:1000 /app/dist /usr/share/nginx/html
USER 1000:1000
EXPOSE 3000
ENTRYPOINT ["nginx", "-g", "daemon off;"]
# nginx.conf — runs as user 1000 on a read-only file system: only /tmp is writable.
worker_processes 1;
pid /tmp/nginx.pid;
error_log /dev/stderr warn;
events { worker_connections 1024; }
http {
include /etc/nginx/mime.types;
# 3D types missing from the stock mime.types (.wasm is already there).
types {
model/gltf-binary glb;
model/gltf+json gltf;
image/ktx2 ktx2;
}
default_type application/octet-stream;
client_body_temp_path /tmp/client_temp;
proxy_temp_path /tmp/proxy_temp;
fastcgi_temp_path /tmp/fastcgi_temp;
uwsgi_temp_path /tmp/uwsgi_temp;
scgi_temp_path /tmp/scgi_temp;
access_log off;
server_tokens off;
sendfile on;
tcp_nopush on;
# Text formats only. .glb / .ktx2 / images are already compressed.
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_comp_level 5;
gzip_types text/css application/javascript text/javascript application/json
image/svg+xml model/gltf+json application/wasm text/plain;
# /assets/ = bundler output whose names carry a content hash (Vite default).
map $uri $cache_control {
~^/assets/ "public, max-age=31536000, immutable";
~*\.(?:glb|gltf|bin|ktx2|basis|hdr|webp|avif|png|jpe?g|svg|mp3|ogg|wasm|js|css|woff2?)$ "public, max-age=3600";
default "no-cache";
}
# Errors (404 etc.) are never cached, so a file added later shows up at once.
map $status $cache_header {
~^(200|206|304)$ $cache_control;
default "no-store";
}
server {
listen 3000;
root /usr/share/nginx/html;
add_header Cache-Control $cache_header always;
# Keeps the site out of search results. Delete this line to be indexed.
add_header X-Robots-Tag "noindex, nofollow" always;
location / {
try_files $uri $uri/ =404;
}
}
}
- 캐시 —
/assets/아래(이름에 해시가 붙은 빌드 결과)는 1년 동안 다시 받지 않고, 그 밖의 모델·이미지·스크립트는 1시간,index.html은 매번 새로 확인해요. 모델을 코드에서import sceneUrl from './models/scene.glb?url'처럼 불러오면 Vite가 해시 이름으로/assets/에 넣어 줘요.public/에 둔 파일은 이름이 그대로라 1시간만 캐시해요. 앱이 보낸Cache-Control·Content-Type·X-Robots-Tag는 RIDM Apps가 바꾸지 않고 그대로 전해요. - 한꺼번에 받는 파일 — 한 방문자가 동시에 받을 수 있는 파일 수는
/assets/경로가 더 넉넉해요. 모델·텍스처가 많으면/assets/로 모으세요. - 압축 — HTML·JS·CSS·JSON·
.gltf·.wasm은 위 설정의 gzip과 앞단의 Brotli로 줄어들어요..glb·.ktx2·이미지는 전송 중에 더 줄지 않으니 파일 자체를 줄이세요: 메시는 Draco나 meshopt, 텍스처는 KTX2(Basis)나 WebP. 예:npx @gltf-transform/cli optimize scene.glb scene.opt.glb --compress meshopt --texture-compress webp(three.js에서는GLTFLoader에MeshoptDecoder·DRACOLoader·KTX2Loader를 연결). - 크기 — 수십 MB 묶음, 파일 하나 15MB 정도는 문제없이 올라가고 서비스돼요. 깃흐름 저장소는 깃흐름 한도, 깃허브 저장소는 GitHub 한도(파일 하나 100MB)를 따르고, 빌드는 20분 안에 끝나야 해요. Git LFS로 올린 파일은 빌드에 들어가지 않으니 일반 커밋으로 넣으세요.
- 월 전송량 — 방문자에게 보낸 파일 크기가 모두 월 전송량에 들어가요. 처음 오는 방문자는 파일을 전부 받으니(30MB 사이트를 1,000명이 처음 열면 약 30GB) 파일을 줄이는 게 가장 효과가 커요. 플랜별 전송량은 요금 페이지에 있어요.
- 검색 노출 — 위 설정은
X-Robots-Tag: noindex로 검색 결과에 나오지 않게 해요. 검색에 나오게 하려면 그 줄을 지우세요.
들어 있는 것
- 앱마다 전용 PostgreSQL DB — 접속 정보가 환경변수(
DATABASE_URL등)로 들어오고, 인증서까지 검증하는 TLS로 연결돼요. - 암호화된 환경변수 — 저장한 값은 암호화되어 보관되고 다시 볼 수 없어요. 저장하면 앱이 새 값으로 다시 시작돼요.
- DB 백업 — 앱 화면에서 DB 덤프를 만들어 내려받을 수 있어요(하루 3번까지).
- 비밀값 차단 — 저장소에 키·토큰·비밀번호가 보이면 빌드를 멈춰 공개를 막아요.
- 내 도메인 연결 — RIDM에서 산 도메인은 콘솔의 도메인 관리 → 앱 연결에서 루트,
www, 또는play.example.com같은 하위 주소(한 단계, 영어 소문자·숫자·하이픈)를 골라 연결해요. DNS 레코드와 인증서는 RIDM이 만들어요. - 어떤 스택이든 — 저장소 루트에
Dockerfile이 있고 포트 3000에서 응답하면 돼요. Next.js 스타터 Dockerfile은 배포 가이드에 있어요.
플랜
- 앱 종류: 일반 앱 / 메타버스 — 호스팅은 하나이고, 콘솔 「내 호스팅」에서 신청할 때 앱 종류를 골라요. 일반 앱 플랜은 앱마다 걸리고, 메타버스 플랜은 계정 하나에 걸려서 모든 공간이 한도를 함께 써요. 아래 플랜 설명은 일반 앱 기준이에요.
- 무료 플랜 — 방문이 있을 때 켜지고 15분 동안 요청이 없으면 멈춰요. 멈춘 뒤 첫 방문은 몇 초 늦을 수 있어요. 파트너당 1개.
- 유료 플랜 — 상시 실행되고, 앱이 죽으면 자동으로 다시 시작해요. 요금은 충전해 둔 크레딧에서 매월 차감돼요.
플랜별 요금·메모리·DB 용량·월 전송량은 요금 페이지에서 확인하세요. 해지하면 이미 결제한 기간이 끝나는 날 멈추고, 그 뒤 30일 동안 데이터를 내려받거나 되돌릴 수 있어요.
알아 둘 제한
- WebSocket은 유료 플랜에서 쓸 수 있어요(앱당 동시 120개, 메시지 64KB). 자세한 한도는 호스팅 문서에 있어요.
- 파일 시스템은 읽기 전용이고, 영구 데이터는 DB에 저장해요.
- 메일 발송 포트(SMTP)는 막혀 있어요. 메일은 HTTPS API 방식의 메일 서비스로 보내요.
- DB 연결은 앱당 동시 3개까지예요.
- 메타버스 한도(계정 하나에 걸리고, 모든 공간 합계) — 무료: 공간 1개·동시 접속 50명·월 전송 10GB·저장 100MB·내 도메인 연결 없음(
<이름>.ridm.ai). 베이직: 공간 5개·동시 접속 200명·월 전송 40GB·저장 3GB·내 도메인 2개. 프로: 공간 20개·동시 접속 500명·월 전송 100GB·저장 10GB·내 도메인 5개. 무료는 전송 한도에 이르면 같이 접속만 멈추고 공간은 열려 있어요. 요금은 요금 페이지, 만드는 법은 메타버스 만들기 책에 있어요.
처음부터 만들어 보고 싶다면
회원제 웹앱을 AI로는 AI 코딩 도구에 시작 문장 한 줄을 주면 가입·로그인과 회원 전용 메모장을 만들어 RIDM Apps에 공개하기까지 안내하는 무료 실행형 전자책이에요. 사주 앱을 만들려면 통합 운세 AI 솔루션을, 사주 API 연동부터 보려면 개발자 시작 가이드를 보세요.
코드 없이 만들고 싶다면 바로(조립형 앱 만들기)에서 사주·운세 블록을 골라 앱을 조립하고, 내려받은 배포 꾸러미를 그대로 RIDM Apps에 올릴 수 있어요.
만들기부터 서버·DB·도메인까지 한 번에 보려면 원스톱 앱 개발을 보세요.
문의: contact@float.do · 운영: 플로트 주식회사