폐쇄망 PC 의 PyCharm · IntelliJ IDEA 등에 플러그인을 넣어야 한다. IDE 안의 Marketplace 는 인터넷이 필요하므로 파일을 미리 받아 옮긴다.
JetBrains Marketplace 에서 플러그인 페이지를 열고 Versions 탭으로 간다. 여기서 IDE 빌드 번호에 맞는 버전을 골라 받는다.
버전을 아무거나 받으면 설치할 때 호환되지 않는다며 거부된다. 대상 IDE 의 빌드 번호를 먼저 확인한다. IDE 의 Help → About 에 PY-243.21565.199 같은 형태로 나온다. Marketplace 의 각 버전에는 지원 빌드 범위가 적혀 있으므로 그 범위에 들어가는 것을 고른다.
받는 파일은 대개 .zip 이고, 단일 jar 로 배포되는 플러그인도 있다. 둘 다 그대로 쓴다. 압축을 풀지 않는다.
가장 간단한 경로다.
File → Settings (macOS 는 PyCharm → Settings)PluginsInstall Plugin from Disk...서버에 헤드리스로 깔려 있거나 IDE 를 띄울 수 없는 경우, 플러그인 디렉터리에 직접 푼다.
플러그인 디렉터리는 설치 경로가 아니라 사용자 설정 디렉터리 아래에 있다.
| OS | 경로 |
|---|---|
| Windows | %APPDATA%\JetBrains\<제품><버전>\plugins |
| Linux | ~/.local/share/JetBrains/<제품><버전> |
| macOS | ~/Library/Application Support/JetBrains/<제품><버전>/plugins |
<제품><버전> 은 PyCharm2025.2 같은 형태다. 실제 경로는 IDE 에서 Help → Show Log in Explorer/Finder 로 열리는 위치의 형제 디렉터리이거나, 로그 파일 첫머리에 적혀 있다.
절차는 다음과 같다.
# IDE 를 완전히 종료한 뒤
cd ~/.local/share/JetBrains/PyCharm2025.2
mkdir -p plugins
unzip -q /tmp/some-plugin-243.zip -d plugins/
ls plugins/
풀고 나면 플러그인 이름의 디렉터리 하나가 생기고 그 안에 lib/ 이 있는 구조여야 한다. zip 안에 최상위 디렉터리가 없어 파일이 plugins/ 바로 아래로 흩어졌다면 잘못된 것이므로 정리하고 다시 푼다.
PC 가 여러 대면 파일을 일일이 옮기는 대신 사내 저장소를 두는 편이 낫다. JetBrains 는 플러그인 저장소를 updatePlugins.xml 하나와 플러그인 파일들로 구성할 수 있게 해 둔다. 웹 서버에 올리고 IDE 의 Settings → Plugins → 톱니바퀴 → Manage Plugin Repositories... 에 URL 을 등록한다.
<plugins>
<plugin id="org.example.myplugin" url="https://repo.example.com/plugins/myplugin-1.2.0.zip" version="1.2.0">
<idea-version since-build="243.0" until-build="243.*"/>
</plugin>
</plugins>
규모가 크면 JetBrains 가 제공하는 관리 도구를 검토한다.
IDE 를 다시 띄우고 Settings → Plugins → Installed 에서 목록에 보이고 켜져 있는지 본다. 목록에 없거나 비활성으로 표시되면 로그를 본다.
tail -n 100 ~/.cache/JetBrains/PyCharm2025.2/log/idea.log
호환 문제면 로그에 incompatible 이나 지원 빌드 범위가 함께 찍힌다.
plugins 디렉터리를 통째로 복사하는 방법은 버전이 같을 때만 안전하다. IDE 버전이 다르면 시작할 때 플러그인이 무더기로 비활성된다.