Хостването на Jenkins на Managed VPS означава да компилирате, тествате и внедрявате проектите си от своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Jenkins е свободен софтуер с лиценз MIT. Това ръководство следва официалната му документация: изборът на версия LTS, инсталиране с Docker Compose или с пакетите за Linux, HTTPS и адресът на Jenkins, агентите, правата, плъгините, резервните копия и обновленията.
Автор: Simon Vasconcelos Lee
Публикувано на 16 ноември 2026 г.Време за четене: 15 минути
jenkins/jenkins и неговите етикети lts или с пакетите за Linux на проекта, зад обратен прокси с HTTPS; после задайте този адрес като адрес на Jenkins.JENKINS_HOME, пазете secrets/master.key отделно и четете ръководството за обновяване на всяка LTS, преди да я приложите.Jenkins се описва като водещия сървър за автоматизация с отворен код. Написан на Java, той предлага над 2000 плъгина, за да автоматизира почти всичко. README изброява най-честите му употреби: компилиране на проекти, пускане на тестове, за да се хващат грешките веднага щом бъдат въведени, статичен анализ на кода и внедряване.
Jenkinsfile, който документацията препоръчва да пазите в системата за контрол на версиите на проекта.Jenkins се разпространява с лиценза MIT. Той позволява да използвате, копирате, променяте, сливате, публикувате, разпространявате, преотстъпвате и продавате софтуера, при едно условие: да запазите бележката за авторските права и текста на лиценза във всяко копие. Можете следователно да пускате Jenkins във фирмата си, за собствените си проекти и за тези на клиентите си, без да купувате лиценз.
Лицензът покрива кода. Името „Jenkins“ е регистрирана търговска марка на LF Charities, Inc., организация, свързана с Linux Foundation, а проектът следва политиката за търговските марки на Linux Foundation. Тази политика се отнася за всеки, който поставя думата в името на собствен продукт или услуга, и за целта предлага форми като „вашият продукт for Jenkins“: прочетете я, ако изграждате предложение около софтуера. Да назовете Jenkins, за да го опишете, както прави това ръководство, е добросъвестна употреба.
Тази публикация е независима от проекта Jenkins, от LF Charities, Inc. и от Linux Foundation и не е свързана с тях, нито спонсорирана или одобрена от тях.
Jenkins излиза в две линии. Седмичната версия носи нови функции и поправки всяка седмица. Линията LTS, от Long-Term Support, тръгва от седмична версия, избирана на всеки 12 седмици за базова, после получава пренесени поправки. Документацията представя етикетите LTS на Docker образа като по-стабилната версия, готова за работна среда: именно нея инсталира това ръководство.
| Линия | Към 8 ноември 2026 г. | Темпо |
|---|---|---|
| LTS | 2.580.2 от 28 октомври 2026 г., след 2.580.1 от 30 септември | Три версии на базова версия, .1, .2 и .3, всяка след две седмици пренасяне и две седмици тестване |
| Седмична | 2.589 | По една версия на седмица |
LTS 2.580.2 изисква Java 21 или Java 25: с всяка друга версия контролерът не се стартира. Проектът предвижда да прекрати поддръжката на Java 21 през септември 2027 г., а на Java 25 през септември 2029 г. Изискването важи за цялата система, контролер, агенти и команден ред; самите ви проекти се компилират с версията на Java, която им подхожда.
Документацията препоръчва официалния образ jenkins/jenkins. Етикетът lts следва LTS с Java 21, lts-jdk25 същата LTS с Java 25, а latest седмичната версия. На сървър с инсталиран Docker създайте папка и поставете в нея този compose.yaml, взет от примера с Caddy в документацията: Caddy посреща посетителите на портове 80 и 443, получава HTTPS сертификата и препраща към Jenkins, достъпен само във вътрешната мрежа.
services:
jenkins:
image: jenkins/jenkins:lts-jdk25
container_name: jenkins
restart: unless-stopped
volumes:
- jenkins_home:/var/jenkins_home
expose:
- "8080"
networks:
- web
caddy:
image: caddy:2
container_name: caddy
restart: unless-stopped
depends_on:
- jenkins
ports:
- "80:80"
- "443:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/config
networks:
- web
networks:
web:
driver: bridge
volumes:
jenkins_home:
caddy_data:
caddy_config:
jenkins.example.com {
encode zstd gzip
reverse_proxy jenkins:8080
}
docker compose up -d
/var/jenkins_home: там се намират всички данни, включително плъгините и конфигурацията. README на образа предпочита този том пред папка на хоста, която може да доведе до проблеми с правата: потребителят jenkins в контейнера има ID 1000.web. Порт 50000 служи на входящите TCP агенти; агентите WebSocket и SSH минават без него, затова тук не е публикуван.2.580.2-lts-jdk25 фиксира версията, докато lts-jdk25 следва текущата LTS.Документацията поставя минимум от 256 MB памет и 1 GB диск, поне 10 GB в Docker контейнер, и препоръчва 4 GB памет или повече и 50 GB диск или повече за малък екип. Тя обяснява, че паметта на контролера варира от 200 MB за малка инсталация до над 70 GB за най-големите; всеки свързан агент заема там 2 или 3 нишки, около 2 MB или повече. Основната част от работата, компилациите, се изпълнява на агентите.
На Managed VPS ни разкажете за проектите си и колко често компилирате: ще ви препоръчаме подходящия размер за контролера и за агентите.
Проектът публикува и пакети за Debian и Ubuntu, Fedora, Red Hat Enterprise Linux и производните му. На Debian или Ubuntu първо инсталирайте Java: документацията настоятелно го препоръчва, защото Jenkins, инсталиран преди Java, може да не намери валидна инсталация на Java при стартиране.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
После добавете хранилището LTS, debian-stable, с неговия ключ за подписване, и инсталирайте Jenkins:
sudo wget -O /etc/apt/keyrings/jenkins-keyring.asc \
https://pkg.jenkins.io/debian-stable/jenkins.io-2026.key
echo "deb [signed-by=/etc/apt/keyrings/jenkins-keyring.asc]" \
https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
/etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt update
sudo apt install jenkins
Пакетът създава услуга systemd и потребител jenkins, изпраща журнала си в journald (journalctl -u jenkins.service), пази данните си в /var/lib/jenkins и слуша на порт 8080, на всички интерфейси. Зад прокси на същия сървър го ограничете до локалния адрес със sudo systemctl edit jenkins, после sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Този блок следва примера за Nginx от документацията, сведен до блока location /, формата, която тя дава за случая, когато Nginx не чете сам файловете на Jenkins:
upstream jenkins {
keepalive 32;
server 127.0.0.1:8080;
}
map $http_upgrade $connection_upgrade {
default upgrade;
'' '';
}
server {
listen 80;
server_name jenkins.example.com;
ignore_invalid_headers off;
location / {
sendfile off;
proxy_pass http://jenkins;
proxy_redirect default;
proxy_http_version 1.1;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_max_temp_file_size 0;
client_max_body_size 10m;
client_body_buffer_size 128k;
proxy_connect_timeout 90;
proxy_send_timeout 90;
proxy_read_timeout 90;
proxy_request_buffering off;
}
}
proxy_pass без наклонена черта накрая: документацията предупреждава, че завършването на тази стойност с наклонена черта създава проблеми.Upgrade и Connection обслужват агентите WebSocket, а map поддържа връзките живи за останалия трафик.proxy_request_buffering off е задължително за командите на командния ред на Jenkins, изпращани през HTTP.client_max_body_size задава максималния размер на качваните файлове, 10 MB в примера.След това Certbot поставя сертификата и се грижи да го подновява:
sudo certbot --nginx
След като Jenkins е онлайн, задайте публичния му адрес, например https://jenkins.example.com/, в Manage Jenkins, System, в раздела Jenkins Location. Jenkins го използва за всеки адрес, който генерира, в интерфейса, както и във файловете на агентите, и за комуникацията с агентите и външните инструменти. Опциите за порта нямат значение за него: важи този адрес.
Jenkins следи собствения си обратен прокси. Ако покаже „It appears that your reverse proxy setup is broken“, първо проверете, че този адрес съвпада с адреса, който използвате, после че проксито изпраща X-Forwarded-Proto, когато получава HTTPS и говори с Jenkins през HTTP, както правят двата примера в това ръководство.
Когато се предоставя под път като /jenkins, а не на собствено име на домейн, Jenkins трябва да знае този път: --prefix=/jenkins, чрез JENKINS_OPTS с Docker или JENKINS_PREFIX с пакетите. Документацията препоръчва един и същи път от двете страни, защото пренаписването му в проксито означава да се поправят много адреси.
При първия достъп Jenkins иска автоматично генерирана парола, която записва в журнала си и в secrets/initialAdminPassword. Отворете своя HTTPS адрес, после я прочетете:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin запазва паролата за отключване като своя парола.Съветникът оставя стратегията за оторизация „Logged-in users can do anything“: всеки влязъл акаунт има пълни права. Тя ви подхожда, докато акаунт имат само хора с пълно доверие. Преди да отворите повече акаунти, преминете към матричната сигурност, описана по-долу.
Една компилация изпълнява команди, които контролират хора, различни от администратора: скриптове за компилиране, тестове, кода на всеки commit. На вградения възел тези команди имат същия достъп до файловата система на контролера като самия Jenkins. Затова документацията препоръчва да не пускате компилации на вградения възел и да ги предавате на агенти, което запазва и процесора и паметта на контролера за собствената му работа.
| Връзка | Как | От страна на мрежата |
|---|---|---|
| SSH | Контролерът се свързва с агента, с плъгина SSH Build Agents | Никакъв порт за отваряне на контролера |
| WebSocket | Агентът се свързва с контролера през неговия HTTPS адрес, от Jenkins 2.217 | Никакъв допълнителен порт: проксито препраща WebSocket |
| Входящ TCP | Агентът се свързва с контролера на отделен TCP порт | Фиксиран порт за отваряне и публикуване, 50000 в Docker образа |
Документацията съветва общи, взаимозаменяеми агенти, подготвени с инструмент за управление на конфигурацията, предварително подготвен образ или контейнер: агент, който падне, тогава се заменя без усилие. При един сървър тя предлага агент, работещ под друг потребител на операционната система, без достъп за четене и запис до JENKINS_HOME и без sudo. На Managed VPS втори VPS може също да служи като агент, оразмерен за вашите компилации.
Контролът на достъпа от агента към контролера, който пречи на компрометиран агент да изпраща команди към контролера, е винаги включен от Jenkins 2.326.
Jenkins разделя удостоверяването, което установява кой сте, от оторизацията, която казва какво можете да правите. Вградената му база с потребители, включена по подразбиране, подхожда на малки екипи; LDAP, Active Directory, SAML или OpenID Connect се включват чрез плъгини. За оторизацията ето стратегиите, които документацията описва:
| Стратегия | Какво дава | Кога да я изберете |
|---|---|---|
| Anyone can do anything | Пълни права, дори на анонимните посетители | Само за локален тест |
| Logged-in users can do anything | Пълни права на всеки влязъл акаунт; настройката, която оставя съветникът | Докато акаунт имат само хора с пълно доверие |
| Matrix-based security | Права, давани по потребител или по група | Отправната точка, която документацията препоръчва за работна среда |
| Project-based Matrix Authorization Strategy | Същата матрица, разширена проект по проект | За да запазите някои проекти за някои хора |
Двете матрични стратегии идват от плъгина Matrix Authorization Strategy, който е сред плъгините, предлагани от съветника. В матрицата давайте малко на редовете anonymous и authenticated: Overall/Administer, дадено на authenticated, се равнява на „Logged-in users can do anything“. Бъдете също толкова внимателни, ако отворите самостоятелната регистрация или доставчик на идентичност, при който всеки може да създаде акаунт.
JENKINS_HOME с ключовете от папката secrets, с която разделът за резервните копия се занимава отделно.Плъгините са това, което прави Jenkins толкова гъвкав, а всеки от тях е код, който работи в контролера. Jenkins проверява Update Center веднъж на всеки 24 часа; обновленията се появяват в раздела Updates на Manage Jenkins, Plugins и влизат в сила след рестартиране. Бутонът Check now налага проверка.
С Docker можете също да изградите собствен образ от jenkins/jenkins и да инсталирате в него плъгините си с jenkins-plugin-cli, от списък plugins.txt, който фиксира версиите им и който инструментът може да обновява. README на образа описва този метод.
Известията за компилациите минават през плъгина Mailer: неуспешна компилация, успех след неуспех или компилация, която става нестабилна, предизвиква имейл. Изпращащият сървър се настройва в Manage Jenkins, System, в раздела E-mail Notification.
На VPS на Simafri пощата излиза през удостоверено SMTP реле, на порт 587: адресът на пощенски акаунт, който вече имате, или Simafri Suite. В разширените опции отметнете Use SMTP Authentication с потребителското име и паролата на акаунта, после Use TLS: тогава плъгинът използва порт 587. Опцията Test configuration by sending test e-mail изпраща тестово съобщение.
Документацията определя резервните копия на контролера като критично важни: те служат за възстановяване след авария, за връщане на конфигурация, променена по грешка, или на повреден или изтрит файл. Всичко се намира в JENKINS_HOME: /var/jenkins_home в Docker образа, /var/lib/jenkins с пакетите.
| Елемент | Какво пази | За архивиране |
|---|---|---|
*.xml, включително config.xml | Основната конфигурация и системната конфигурация | Задължително |
jobs/ | Задачите и историята на компилациите; в builds/archive, архивираните артефакти | Задължително; артефактите според нуждите, те стават обемни |
plugins/*.jpi | Инсталираните плъгини, в техните версии | Препоръчително, за идентично възстановяване |
secrets/ | Ключовете, които шифроват идентификационните данни | Папката, без master.key, пазен отделно |
workspace/ | Файловете, изтеглени от контрола на версиите за компилациите | По желание: ново изтегляне ги създава отново |
war/, cache/, tools/ | Разархивираният WAR, изтеглените и разархивирани инструменти | По желание: създават се отново при нужда |
Документацията моли никога да не поставяте главния ключ в обичайното си резервно копие. secrets/master.key шифрова ключа, който защитава идентификационните ви данни: който държи резервните ви копия и този ключ, може да прочете всичко. Копирайте го веднъж и го пазете отделно на много сигурно място, като частен SSH ключ; пълното възстановяване се нуждае от него.
README на образа моли да третирате jenkins_home като база данни. Спрете Jenkins за времето на копирането, после архивирайте тома с временен контейнер, по метода от документацията на Docker:
docker compose stop jenkins
docker run --rm --volumes-from jenkins -v "$(pwd)":/backup ubuntu \
tar -czf /backup/jenkins_home-$(date +%F).tar.gz --exclude=./secrets/master.key -C /var/jenkins_home .
docker compose start jenkins
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key
sudo systemctl stop jenkins
sudo tar -czf jenkins_home-$(date +%F).tar.gz --exclude=./secrets/master.key -C /var/lib/jenkins .
sudo systemctl start jenkins
Копие, направено при спряна услуга, е съгласувано. За да архивирате, без да спирате, документацията насочва към моментните снимки на файловата система, LVM, btrfs или ZFS, по-съгласувани и по-бързи от копиране в движение; сред плъгините за архивиране с отворен код тя посочва thinBackup като единствения, който още се поддържа. Давайте на всяко копие име с дата и час, избягвайте /tmp, който може да се почиства при рестартиране, и изпращайте готовите копия на отдалечен сървър.
Пазени на диска на сървъра, тези архиви влизат и в нощните му резервни копия.
Документацията моли да проверявате всяко резервно копие и дава простия метод: възстановете го във временна папка, върнете master.key и стартирайте върху него втори Jenkins със същата версия, на друг порт:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Преди всяко обновяване на ядрото прочетете страницата на целевата LTS в ръководствата за обновяване на проекта: всеки раздел покрива обновяването от предишната LTS. За 2.580.2 тя не изброява значими промени. За 2.580.1 отбелязва, че няколко плъгина, отделени от ядрото, вече не се включват в WAR: Jenkins ги инсталира сам, когато Update Center е достъпен. После архивирайте JENKINS_HOME и обновете:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Jenkins остава ваш софтуер, с неговите pipelines, настройки и данни.
| Тема | Нашите екипи | Вие |
|---|---|---|
| Сървърът | Обновления на системата и на сигурността, включително намеси на сървъра | Моментът, който пасва на вашата дейност |
| Наблюдението | Сървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането ви | Четенето на журналите на вашата инстанция и на компилациите ви |
| Jenkins | Проактивно проследяване: грешки, забавяния и дисково пространство се откриват, препоръчва се корекция | Инсталирането, обновяванията, плъгините и настройките му, които прилагате вие или вашият AI асистент |
| Pipelines и агентите | Сървърите, които ги носят, наблюдавани и архивирани | Задачите, агентите, акаунтите, правата и идентификационните данни |
| Резервните копия | Всяка нощ, криптирани и пазени извън машината; възстановяването е включено | Архивите, специфични за Jenkins, файлът master.key и заявката за възстановяване, когато ви потрябва |
| Миграцията | Сегашният ви сървър е мигриран, безплатно | Моментът на превключването |
Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.
С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Jenkins, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.
Да. Jenkins е с лиценз MIT: можете да го използвате, променяте и пускате във фирмата си, без да купувате лиценз, стига да запазите бележката за авторските права и за лиценза. Остава цената на сървърите, които носят контролера и агентите.
Линията LTS, която документацията представя като готова за работна среда: 2.580.2 към 28 октомври 2026 г. Тя изисква Java 21 или Java 25. Нова базова версия LTS се избира на всеки 12 седмици, а всяка базова версия получава три версии с поправки.
Използвайте официалния образ jenkins/jenkins с етикет LTS, като lts-jdk25, и именуван том, монтиран на /var/jenkins_home. Поставете пред него обратен прокси с HTTPS, например Caddy в същия файл compose.yaml, после задайте публичния адрес като адрес на Jenkins.
В журнала при стартиране и във файла secrets/initialAdminPassword на JENKINS_HOME: /var/jenkins_home с Docker образа, /var/lib/jenkins с пакетите. Поставете я на страницата Unlock Jenkins, после създайте собствения си администраторски акаунт.
Документацията препоръчва да ги изпълнявате на агенти: на вградения възел компилацията има същия достъп до файловете на контролера като Jenkins. Свържете агент, през SSH или WebSocket, после задайте изпълнителите на вградения възел на 0.
Предоставяйте я през HTTPS зад обратен прокси, преминете към матричната сигурност, запазете Overall/Administer за хора с доверие, оставете защитата от CSRF включена, пускайте компилациите на агенти и прилагайте своевременно версиите LTS, които носят поправки за сигурността.
Архивирайте JENKINS_HOME при спряна услуга или чрез моментна снимка на файловата система. Дръжте secrets/master.key извън това копие, пазен отделно на много сигурно място, и проверявайте всяко резервно копие, като го възстановявате на тестов Jenkins, стартиран на друг порт.
Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.
Simafri
Да поговорим за Вашия проект
Кажете ни с няколко думи от какво имате нужда: отговаряме Ви бързо.
Благодарим! Вашето запитване е изпратено. Ще се свържем с вас скоро.
Предпочитате имейл? Пишете ни на support@simafri.com.