Fusio
오픈 소스 API 관리 플랫폼으로, 비즈니스 로직을 빠르게 확장 가능한 API 제품으로 전환하여 인간 개발자와 AI 에이전트 모두에게 서비스를 제공합니다.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
자체 API 게이트웨이 구축, 수익화 및 AI 연동 기능 내장, 대량의 코드 작성 불필요.
주요 기능
- 데이터베이스 API 게이트웨이: 한 번의 클릭으로 MySQL/PostgreSQL 등을 REST 인터페이스로 노출
- 마이크로서비스 게이트웨이: 보안 라우팅, 오케스트레이션 및 로드 밸런싱
- 사용자 정의 로직: PHP 또는 JavaScript로 Action 작성
- AI 지원 개발: 자연어로 백엔드 로직 생성 (Ollama/ChatGPT/Gemini 지원)
- MCP 지원: 모델 컨텍스트 프로토콜을 네이티브로 구현하여 AI 생태계와 연동
할 수 없는 것
- •프로덕션 환경에서는 반드시 Nginx/Apache를 사용해야 하며 PHP 내장 서버는 사용할 수 없습니다. 처음 실행하기 전에 반드시 `FUSIO_PROJECT_KEY`와 데이터베이스 비밀번호를 변경해야 합니다. 하위 디렉터리에 배포하는 경우 도메인을 잘못 가져오는 문제를 방지하기 위해 `APP_URL` 환경 변수를 수동으로 설정해야 합니다.
사용 사례
- 레거시 데이터베이스를 빠르게 REST API로 래핑하여 프론트엔드 또는 서드파티에서 사용할 수 있도록 제공
- 유료화 가능한 API 제품 구축(예: 날씨, 결제, 데이터 서비스)
- AI 에이전트(예: ChatGPT 플러그인, Claude 도구)를 위한 백엔드 도구 인터페이스 제공
상세 설명
Fusio는 자체 호스팅 오픈소스 API 관리 플랫폼으로, 내부 인프라와 외부 세계를 연결하는 다리 역할을 합니다. 레거시 데이터베이스(MySQL, PostgreSQL 등)를 즉시 REST API로 노출하고, 마이크로서비스를 오케스트레이션하며, PHP 또는 JavaScript로 커스텀 비즈니스 로직을 작성할 수 있고, 구독 플랜, 자동 결제 등 수익화 기능도 제공합니다. MCP 프로토콜을 네이티브로 지원하여 AI 에이전트가 API를 도구처럼 사용할 수 있습니다. 또한 개발자 포털, 자동 SDK 생성, 분석 및 모니터링 기능이 내장되어 있습니다. Docker 원클릭 배포 또는 수동 설치를 지원합니다.
문제 해결 & FAQ (1)
문제 해결client_credentials 토큰 요청 시 발생하는 Fusio `SQLSTATE[22001] value too long for type character varying(1023)` 오류를 해결하는 방법
이 문제는 scope 파라미터를 보내지 않을 때 발생합니다. Fusio가 앱에 부여된 모든 스코프를 쉼표로 구분된 문자열로 fusio_token.scope에 삽입하는데, 이 컬럼은 1023자로 제한되어 있습니다. 해결 방법: 필요한 스코프만 명시적으로 요청하세요. 예를 들어:
curl -X POST https://your-fusio/authorization/token \
-u "APP_KEY:APP_SECRET" \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data 'grant_type=client_credentials&scope=backend.user,backend.action'
또한 backend.user처럼 더 좁은 스코프로 충분한 경우에는 backend와 같은 광범위한 루트 스코프를 할당하지 마세요. 루트 스코프는 많은 하위 스코프로 확장되기 때문입니다. 앱/사용자에서 사용하지 않는 권한은 제거하세요.
자체 호스팅 PostgreSQL의 경우, 긴 스코프 목록이 필요하다면 컬럼을 수동으로 확장할 수 있습니다:
ALTER TABLE fusio_token ALTER COLUMN scope TYPE TEXT;
ALTER TABLE fusio_app_code ALTER COLUMN scope TYPE TEXT;
최신 Fusio 릴리스에서는 스코프 문자열이 컬럼 제한을 초과할 때 명시적인 예외를 발생시켜 원인을 더 명확하게 알 수 있지만, 즉각적인 해결 방법은 더 짧은 명시적 scope를 보내거나 부여된 스코프를 줄이는 것입니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
Docker와 docker-compose가 설치되어 있는지 확인하세요
docker-compose.yml 파일을 생성하고, 내용은 프로젝트 README의 설정을 참조하세요 (데이터베이스 비밀번호와 프로젝트 키를 수정하는 데 주의하세요)
`docker compose up -d`를 실행하여 서비스를 시작하세요
- Docker와 docker-compose가 설치되어 있는지 확인하세요
- docker-compose.yml 파일을 생성하고, 내용은 프로젝트 README의 설정을 참조하세요 (데이터베이스 비밀번호와 프로젝트 키를 수정하는 데 주의하세요)
- `docker compose up -d`를 실행하여 서비스를 시작하세요
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
컨테이너 중지: `docker compose down`, 데이터 볼륨 삭제 `docker volume rm <volumes>` 또는 docker-compose.yml이 있는 디렉토리를 직접 삭제합니다. 수동 설치의 경우 프로젝트 디렉토리를 삭제하고 데이터베이스를 정리합니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
1 FAQ
유사한 프로젝트
Visual Studio Code (Code - OSS)
Microsoft가 만든 무료 오픈 소스 코드 편집기로, 지능형 자동 완성, 디버깅, Git 및 확장 기능을 지원하는 전 세계에서 가장 인기 있는 편집기입니다.
opencode
오픈소스 AI 코딩 에이전트로, 코드 작성, 리팩토링 및 분석을 지원하며, '빌드(Build)'와 '플랜(Plan)' 이중 에이전트 모드가 내장되어 있습니다.
scrcpy
USB 또는 무선 TCP/IP를 통해 컴퓨터에서 Android 기기로 화면 미러링 및 제어를 지원하며, 루팅 불필요, 고성능 저지연, 오디오 전달 지원.