스킬 uvicorn
📦

uvicorn

콘텐츠 리비전 r2 안전 ⚙️ 외부 명령어🌐 네트워크 접근📁 파일 시스템 접근

Uvicorn으로 Python ASGI 앱 실행

비동기 Python 서비스에는 개발 및 배포를 위한 명확한 서버 설정이 필요합니다. 이 스킬은 간결한 Uvicorn 명령, 구성 지침, 문제 해결 단계를 제공합니다.

지원: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 78 브론즈

내 에이전트로 설치

이 요청을 에이전트에 복사하세요. 공식 Skill 페이지와 매니페스트가 포함되어 있습니다.

에이전트 요청
Review the Skillstore skill "uvicorn" from https://skillstore.io/skills/bossjones-uvicorn.md and its manifest at https://skillstore.io/api/skills/bossjones-uvicorn/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

에이전트는 계속해서 계획을 표시하고 보안 정책에서 요구하는 확인을 요청해야 합니다.

에이전트가 읽기 쉬운 리소스

AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.

Markdown 상세 GET /skills/bossjones-uvicorn.md 서명된 manifest GET /api/skills/bossjones-uvicorn/manifest 서명된 lockfile GET /api/skills/bossjones-uvicorn/lockfile

테스트해 보기

"uvicorn" 사용 중입니다. 개발 중 FastAPI 앱을 실행해야 합니다.

예상 결과:

  • 응답은 앱 import 대상을 식별하고, reload는 개발용으로만 권장하며, 명시적인 port를 선택할 것입니다.
  • 또한 module을 import할 수 없는 경우 working directory를 확인하라고 알려줄 것입니다.

"uvicorn" 사용 중입니다. ASGI 서비스를 위한 프로덕션 지침이 필요합니다.

예상 결과:

  • 응답은 개발 플래그와 프로덕션 설정을 분리하고 worker processes를 언제 사용할지 설명할 것입니다.
  • logging, certificate file 처리, process manager 고려 사항을 포함할 것입니다.

"uvicorn" 사용 중입니다. 컨테이너는 시작되지만 앱에 접근할 수 없습니다.

예상 결과:

  • 응답은 container port mapping, host binding, 이미지에서 사용하는 Uvicorn command를 확인할 것입니다.
  • 애플리케이션 코드를 변경하기 전에 networking configuration에 집중할 것입니다.

보안 감사

안전
v8 • 2026. 7. 23. 버전별 보고서 열기

The 45 external-command alerts are false positives caused by Markdown fences and inline option formatting; no backtick execution exists. Temporary socket usage, placeholder TLS paths, container binding, loopback documentation, and worker-option text are legitimate examples. Five examples bind to all interfaces without sufficient exposure warnings, and four also use development reload settings.

1
스캔된 파일
232
분석된 줄 수
5
검토 항목
0
오탐 무시됨
기능 검토 항목 (5)

이 스킬에 대해 예상될 수 있는 실제 로컬 기능이므로 검토가 필요하지만, 확인된 악의적 동작으로는 집계되지 않습니다.

중간
SKILL.md:25
Hardcoded IP address
uv run uvicorn main:app --host 0.0.0.0 --port 8000
The example binds Uvicorn to every network interface without an exposure warning. This can make an unprotected application reachable from other hosts.
중간
SKILL.md:93
Hardcoded IP address
uvicorn.run("main:app", host="0.0.0.0", port=8000, reload=True)
The programmatic example combines an all-interface bind with reload mode. This can expose a development server and its changing code to the network.
중간
SKILL.md:112
Hardcoded IP address
export UVICORN_HOST="0.0.0.0"
The environment configuration binds all interfaces and enables reload before starting Uvicorn. No warning or access-control requirement accompanies the example.
중간
SKILL.md:157
Hardcoded IP address
--host 0.0.0.0 \
The combined CLI example binds all interfaces and enables reload. It can expose a development server beyond the local machine.
중간
SKILL.md:207
Hardcoded IP address
command: uvicorn main:app --host 0.0.0.0 --port 8000 --reload
The Compose example publishes the port, binds all interfaces, and enables reload. This explicitly exposes a development server on the host network.

위험 요인

⚙️ 외부 명령어 (45)
SKILL.md:20-29 SKILL.md:29-35 SKILL.md:35-49 SKILL.md:49-53 SKILL.md:53-62 SKILL.md:62-64 SKILL.md:64-66 SKILL.md:66-70 SKILL.md:70-80 SKILL.md:80-82 SKILL.md:82-84 SKILL.md:84-88 SKILL.md:88-94 SKILL.md:94-96 SKILL.md:96-107 SKILL.md:107-111 SKILL.md:111-116 SKILL.md:116-122 SKILL.md:122-127 SKILL.md:127-131 SKILL.md:131-137 SKILL.md:137-141 SKILL.md:141-143 SKILL.md:143-147 SKILL.md:147-149 SKILL.md:149-155 SKILL.md:155-164 SKILL.md:164-168 SKILL.md:168-169 SKILL.md:169-170 SKILL.md:170-171 SKILL.md:171-172 SKILL.md:172-173 SKILL.md:173-174 SKILL.md:174-180 SKILL.md:180-193 SKILL.md:193-197 SKILL.md:197-208 SKILL.md:208-215 SKILL.md:215-216 SKILL.md:216-217 SKILL.md:217 SKILL.md:221-223 SKILL.md:223-227 SKILL.md:227-231
🌐 네트워크 접근 (7)
SKILL.md:25 SKILL.md:93 SKILL.md:112 SKILL.md:157 SKILL.md:168 SKILL.md:192 SKILL.md:207
📁 파일 시스템 접근 (1)
SKILL.md:148
감사자: codex 감사 이력 보기 →
이 보고서 공유 및 인용

버전이 지정된 평가 보고서, 중립 배지, 임베드 카드 및 인용을 공유하세요. Skillstore는 근거를 보고하지만 이 Skill의 안전 여부를 판단하지 않습니다.

버전별 보고서 열기
보안 평가

보고서 링크 복사

https://skillstore.io/skills/bossjones-uvicorn/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 배지

[![Skillstore security assessment](https://skillstore.io/badges/skills/bossjones-uvicorn/security.svg)](https://skillstore.io/skills/bossjones-uvicorn?utm_source=security_passport_badge)

HTML 배지

<a href="https://skillstore.io/skills/bossjones-uvicorn?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/bossjones-uvicorn/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

임베드 카드

<iframe src="https://skillstore.io/embed/skills/bossjones-uvicorn.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
학술 인용 (APA · BibTeX · CFF)

APA 인용

bossjones. (2026). uvicorn security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/bossjones-uvicorn/audits/8

BibTeX 인용

@techreport{bossjones-bossjones-uvicorn-2026, author = {bossjones}, title = {uvicorn security audit report (audit version 8)}, institution = {Skillstore}, year = {2026}, number = {8}, url = {https://skillstore.io/skills/bossjones-uvicorn/audits/8}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "uvicorn security audit report (audit version 8)" version: "unspecified" type: report authors: - name: "bossjones" date-released: "2026-07-23" url: "https://skillstore.io/skills/bossjones-uvicorn/audits/8" identifiers: - type: other value: "skillstore:bossjones-uvicorn:audit:8" description: "Skillstore immutable audit report identifier"

Skillstore 점수

이 점수의 이유 증거 신뢰도: 높음
55
아키텍처
85
유지보수성
87
콘텐츠
70
커뮤니티
83
사양 준수

만들 수 있는 것

로컬 개발 서버 시작

이 가이드를 사용해 reload와 명확한 port 설정으로 FastAPI 또는 Starlette 앱을 실행합니다.

프로덕션 프로세스 모델 준비

ASGI 서비스를 배포하기 전에 worker, logging, SSL, Gunicorn 패턴을 검토합니다.

Docker에서 Uvicorn 구성

Dockerfile 및 Compose 지침을 적용해 컨테이너에서 ASGI 애플리케이션을 노출합니다.

이 프롬프트를 사용해 보세요

Uvicorn 시작 
로컬 개발을 위해 Uvicorn으로 내 FastAPI 애플리케이션을 시작하는 방법을 보여주세요.
개발 설정 조정 
host, port, reload, log level에 대한 Uvicorn 개발 설정을 선택하도록 도와주세요.
프로덕션 배포 계획 
workers, access logs, SSL 고려 사항을 포함한 프로덕션 Uvicorn 프로세스 설정을 추천해주세요.
컨테이너 구성 검토 
내 Docker 기반 Uvicorn 배포 계획을 검토하고 외부 접근 또는 reload 동작을 깨뜨릴 수 있는 설정을 찾아주세요.

모범 사례

  • reload는 파일 변경 시 프로세스를 재시작하므로 로컬 개발에서만 사용하세요.
  • 반복 가능한 배포를 위해 명시적인 host, port, log level, worker 선택을 설정하세요.
  • HTTPS를 활성화하기 전에 certificate key files를 보호하고 file permissions를 확인하세요.

피하기

  • reload mode를 프로덕션 worker process 계획과 함께 사용하지 마세요.
  • 적절한 deployment boundary 없이 development server를 신뢰할 수 없는 네트워크에 노출하지 마세요.
  • 서버가 loopback address에만 바인딩된 경우 Docker port publishing이 동작한다고 가정하지 마세요.

자주 묻는 질문

이 스킬은 어떤 프레임워크에 도움이 되나요?
FastAPI, Starlette, Django Channels 및 유사한 비동기 Python 서비스를 포함한 ASGI 애플리케이션에 도움이 됩니다.
이 스킬은 명령을 자동으로 실행하나요?
아니요. 사용자 또는 agent가 프로젝트에 맞게 조정할 수 있는 문서와 예제를 제공합니다.
로컬 hot reload에 도움이 되나요?
예. 개발을 위한 reload mode와 관련 directory, port, logging 선택을 설명합니다.
프로덕션 배포에 도움이 되나요?
예. workers, Gunicorn integration, SSL file options, Unix sockets, container examples를 다룹니다.
Uvicorn documentation을 대체하나요?
아니요. 이는 간결한 작업 가이드이며, 버전별 동작은 공식 Uvicorn documentation에서 확인해야 합니다.
Uvicorn 시작에 실패하면 무엇을 확인해야 하나요?
app import path, active environment, port availability, watched directories, 호환되지 않는 reload 또는 worker settings를 확인하세요.

개발자 세부 정보

작성자

bossjones

라이선스

MIT

Skillstore 리비전

r2

버전 안내

작성자가 버전을 선언하지 않았습니다.

리포지토리

https://github.com/bossjones/logging-lab/tree/main/.claude/skills/uvicorn

참조

a39a91716eadede5f4cdefd78178fed4e837a128

유지보수 최신성

2026. 7. 25.

사용량

8 다운로드 · 183 조회

파일 구조

📄 SKILL.md

bossjones의 다른 스킬

전체 보기

관련 스킬

전체 보기