Envi

암호화된 저장 및 공유

Envi는 환경 변수 파일을 GitHub Gists에 저장할 때, 변수 이름은 보이지만 값은 마스킹 암호화하거나 전체 파일을 암호화하는 두 가지 암호화 옵션을 제공합니다. PBKDF2 키 유도 함수와 100,000번의 반복을 통해 산업 표준 수준의 보안을 구현하며, 키 파일 기반 암호화도 지원하여 자동화 환경에서의 사용성을 높였습니다.

안전한 토큰 관리

GitHub 토큰은 시스템의 자격 증명 관리자에 안전하게 저장되며, 실시간 API 검증을 통해 토큰의 유효성과 권한을 확인합니다. 토큰은 명령줄에 노출되지 않도록 인터랙티브 프롬프트로만 입력받으며, 정기적인 교체와 최소 권한(gist scope) 사용을 권장합니다.

팀 협업을 위한 공유 기능

사용자는 특정 GitHub 사용자와 환경 변수를 공유하거나, 공유 가능한 URL을 생성할 수 있습니다. 키 파일과 함께 공유 시 수신자는 키 파일과 비밀번호를 모두 가져야 복호화할 수 있어, 채널 분리 보안을 강화합니다. 자체 포함 암호화 공유(–self-contained) 옵션은 비밀번호만으로도 복호화 가능한 패키지를 생성합니다.

다운로드·설치 방법

Windows 사용자는 Chocolatey 또는 Scoop 패키지 관리자를 통해 Envi를 쉽게 설치할 수 있습니다. Chocolatey의 경우 choco install envi 명령을 실행하면 되며, Scoop은 먼저 버킷을 추가한 후 scoop install envi로 설치합니다. 수동 설치를 원한다면 GitHub 릴리스 페이지에서 최신 바이너리를 다운받아 PATH에 등록된 디렉터리에 배치하면 됩니다.

기본 사용법/명령어

설치 후 먼저 GitHub 토큰을 설정해야 합니다. 토큰은 Gist 범위(scope)가 필요하며, envi config --token YOUR_GITHUB_TOKEN 명령으로 등록합니다. 토큰은 시스템 자격 증명 관리자에 안전하게 저장됩니다.

현재 프로젝트의 .env 파일을 개인 Gist에 푸시하려면 envi push 명령을 사용합니다. 이 명령은 기본적으로 마스킹 암호화를 적용하며, --encrypt 플래그로 전체 파일 암호화로 변경할 수 있습니다.

다른 머신에서 환경 변수를 받아오려면 GIST ID를 알고 있어야 하며, envi pull --id GIST_ID 명령으로 파일을 다운로드받을 수 있습니다. 암호화된 상태라면 --unmask 플래그를 추가하여 값을 복호화합니다.

자주 사용하는 명령어는 다음과 같습니다:

• envi list: 내 GitHub Gists 중 .env 파일이 있는 목록 보기
• envi validate: 현재 .env 파일의 형식 검증 (빈 값 허용)
• envi validate --strict: 빈 값 금지한 엄격 검증
• envi merge --files .env.base,.env.local: 여러 .env 파일 병합
• envi --version: 현재 설치된 Envi 버전 확인

이런 경우에 유용합니다

여러 개발 환경(로컬, 스테이징, 프로덕션)에서 서로 다른 환경 변수를 관리해야 하는 팀에게 유용합니다. 예를 들어, 데이터베이스 자격 증명이나 API 키와 같은 민감한 정보를 암호화된 Gist에 저장하고, 팀원이 안전한 채널로 비밀번호를 공유한 후 envi pull로 최신 설정을 받아올 수 있습니다. 키 파일 기반 암호화를 사용하면 CI/CD 파이프라인에서도 비밀번호 입력 없이 자동으로 환경 변수를 복호화할 수 있습니다.

지원 환경·시스템 요구사항

Envi는 Windows, macOS, Linux에서 실행 가능한 단일 바이너리로 배포됩니다. Windows에서는 Chocolatey나 Scoop을 통해 설치 시 자동으로 PATH에 등록되며, 수동 설치 시 다운로드한 envi.exe 파일을 시스템 PATH가 포함된 폴더에 놓으면 됩니다. 별도의 런타임(예: .NET, JVM)은 필요하지 않으며, Go로 컴파일된 네이티브 실행 파일입니다.

최신 버전·업데이트

현재 버전은 1.0.9이며, 최신 업데이트 정보는 GitHub 저장소의 릴리스 페이지에서 확인할 수 있습니다. 버전 확인은 envi --version 또는 envi -v 명령으로 가능합니다.

제한 사항·확인 사항

Envi를 사용하려면 GitHub 계정과 Gist 범위가 부여된 개인 액세스 토큰이 필수입니다. 토큰이 없거나 잘못된 범위로 발급된 경우 인증 오류가 발생하며, envi config --token 명령으로 재설정해야 합니다. 또한, 암호화에 사용되는 비밀번호나 키 파일은 분실 시 복구할 수 없으므로 안전한 보관이 필요합니다.

화면으로 보는 주요 기능

envi 로고와 캐릭터

파란색 곰 캐릭터가 '.env'라고 쓰인 문서를 들고 있으며, 그 아래에 'envi'라는 텍스트가 보입니다.