TraceApps/nutritrace

어떤 프로젝트인가요?

핵심 기능

• 01설정 가능한 식사 시간대와 매크로 분석을 지원하는 일일 식단 일지
• 02개인 식품 데이터베이스와 레시피, Open Food Facts 및 USDA 검색 지원
• 03고정형·동적형·적응형 칼로리 목표
• 04Fitbit, Withings, Garmin, Health Connect 연동
• 05OIDC 싱글 사인온 및 여러 사용자 지원
• 06오프라인 브라우저 모드와 재연결 시 동기화

활용 사례

• 홈 서버나 NAS에서 비공개로 칼로리와 매크로 추적
• 기존 SSO 환경에서 가족이나 소규모 그룹용 영양 추적기 운영
• 데이터를 자체 네트워크에 보관하면서 클라우드 칼로리 기록 앱 대체
• MyFitnessPal 또는 Cronometer에서 기존 식단 일지 가져오기

빠른 시작

1. 1

   JWT 시크릿을 설정한 뒤 README에서 docker-compose.yml을 저장합니다

2. 2

   JWT 시크릿을 생성합니다

   openssl rand -base64 48
3. 3

   컨테이너를 시작합니다

   docker compose up -d
4. 4

   http://localhost:3001 을 열고 최초 실행 마법사를 완료합니다

사용 전 알아둘 점

• !iOS 앱은 아직 제공되지 않습니다.
• !Open Food Facts, USDA 및 웰니스 정보 조회 등의 일부 기능은 인터넷 연결이 필요하며, 일부 기능에는 API 키가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

nutritrace은(는) 무엇인가요?

PWA와 Android 앱을 제공하며 단일 Docker 컨테이너로 실행하는 셀프 호스팅 개인 영양·칼로리 기록 앱입니다. NutriTrace는 직접 호스팅하는 개인 식단 일지이자 칼로리·매크로 추적 앱입니다. 서버는 Docker 컨테이너 하나로 실행되며, 브라우저 PWA나 네이티브 Android 앱으로 사용할 수 있습니다. 외부 서비스 계정이나 텔레메트리를 사용하지 않으며, 서드파티 연동을 활성화하지 않는 한 데이터는 자체 하드웨어에 보관됩니다.

nutritrace은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

nutritrace은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

nutritrace은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. nutritrace의 마지막 커밋은 2026년 11월 7일입니다.

nutritrace은(는) 어디에 사용할 수 있나요?

홈 서버나 NAS에서 비공개로 칼로리와 매크로 추적 기존 SSO 환경에서 가족이나 소규모 그룹용 영양 추적기 운영 데이터를 자체 네트워크에 보관하면서 클라우드 칼로리 기록 앱 대체 MyFitnessPal 또는 Cronometer에서 기존 식단 일지 가져오기

nutritrace는 어떻게 설치하나요?

JWT 시크릿을 설정한 뒤 README에서 docker-compose.yml을 저장합니다 JWT 시크릿을 생성합니다: openssl rand -base64 48 컨테이너를 시작합니다: docker compose up -d http://localhost:3001 을 열고 최초 실행 마법사를 완료합니다

nutritrace은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/TraceApps/nutritrace