Хостване на Jenkins® на Managed VPS: компилациите ви на ваш сървър

Хостването на Jenkins на Managed VPS означава да компилирате, тествате и внедрявате проектите си от своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Jenkins е свободен софтуер с лиценз MIT. Това ръководство следва официалната му документация: изборът на версия LTS, инсталиране с Docker Compose или с пакетите за Linux, HTTPS и адресът на Jenkins, агентите, правата, плъгините, резервните копия и обновленията.

Simon Vasconcelos Lee Автор: Публикувано на 16 ноември 2026 г.Време за четене: 15 минути

Всички ръководства

Накратко

  1. Лицензът MIT позволява свободно да използвате Jenkins във фирмата си, стига да запазите бележката за лиценза. Името е предмет отделно на политиката за търговските марки, която проектът е приел, тази на Linux Foundation.
  2. Изберете линията LTS: 2.580.2 към 28 октомври 2026 г., която работи с Java 21 или Java 25. Нова базова версия LTS се избира на всеки 12 седмици.
  3. Инсталирайте го с официалния образ jenkins/jenkins и неговите етикети lts или с пакетите за Linux на проекта, зад обратен прокси с HTTPS; после задайте този адрес като адрес на Jenkins.
  4. Пускайте компилациите на агенти и задайте изпълнителите на контролера на 0. Давайте права с матричната сигурност и оставете защитата от CSRF включена.
  5. Архивирайте JENKINS_HOME, пазете secrets/master.key отделно и четете ръководството за обновяване на всяка LTS, преди да я приложите.

Какво прави Jenkins

Jenkins се описва като водещия сървър за автоматизация с отворен код. Написан на Java, той предлага над 2000 плъгина, за да автоматизира почти всичко. README изброява най-честите му употреби: компилиране на проекти, пускане на тестове, за да се хващат грешките веднага щом бъдат въведени, статичен анализ на кода и внедряване.

Лицензът MIT и търговската марка

Jenkins се разпространява с лиценза MIT. Той позволява да използвате, копирате, променяте, сливате, публикувате, разпространявате, преотстъпвате и продавате софтуера, при едно условие: да запазите бележката за авторските права и текста на лиценза във всяко копие. Можете следователно да пускате Jenkins във фирмата си, за собствените си проекти и за тези на клиентите си, без да купувате лиценз.

Лицензът покрива кода. Името „Jenkins“ е регистрирана търговска марка на LF Charities, Inc., организация, свързана с Linux Foundation, а проектът следва политиката за търговските марки на Linux Foundation. Тази политика се отнася за всеки, който поставя думата в името на собствен продукт или услуга, и за целта предлага форми като „вашият продукт for Jenkins“: прочетете я, ако изграждате предложение около софтуера. Да назовете Jenkins, за да го опишете, както прави това ръководство, е добросъвестна употреба.

Тази публикация е независима от проекта Jenkins, от LF Charities, Inc. и от Linux Foundation и не е свързана с тях, нито спонсорирана или одобрена от тях.

LTS или седмична: коя версия да инсталирате

Jenkins излиза в две линии. Седмичната версия носи нови функции и поправки всяка седмица. Линията LTS, от Long-Term Support, тръгва от седмична версия, избирана на всеки 12 седмици за базова, после получава пренесени поправки. Документацията представя етикетите LTS на Docker образа като по-стабилната версия, готова за работна среда: именно нея инсталира това ръководство.

ЛинияКъм 8 ноември 2026 г.Темпо
LTS2.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, която им подхожда.

Инсталиране с Docker Compose

Документацията препоръчва официалния образ jenkins/jenkins. Етикетът lts следва LTS с Java 21, lts-jdk25 същата LTS с Java 25, а latest седмичната версия. На сървър с инсталиран Docker създайте папка и поставете в нея този compose.yaml, взет от примера с Caddy в документацията: Caddy посреща посетителите на портове 80 и 443, получава HTTPS сертификата и препраща към Jenkins, достъпен само във вътрешната мрежа.

compose.yaml
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:
Caddyfile
jenkins.example.com {
  encode zstd gzip
  reverse_proxy jenkins:8080
}
Терминал
docker compose up -d

Оразмеряване на сървъра

Документацията поставя минимум от 256 MB памет и 1 GB диск, поне 10 GB в Docker контейнер, и препоръчва 4 GB памет или повече и 50 GB диск или повече за малък екип. Тя обяснява, че паметта на контролера варира от 200 MB за малка инсталация до над 70 GB за най-големите; всеки свързан агент заема там 2 или 3 нишки, около 2 MB или повече. Основната част от работата, компилациите, се изпълнява на агентите.

На Managed VPS ни разкажете за проектите си и колко често компилирате: ще ви препоръчаме подходящия размер за контролера и за агентите.

С пакетите за Debian или Ubuntu

Проектът публикува и пакети за 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 и Certbot

Този блок следва примера за Nginx от документацията, сведен до блока location /, формата, която тя дава за случая, когато Nginx не чете сам файловете на Jenkins:

Блок на Nginx
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;
  }
}

След това Certbot поставя сертификата и се грижи да го подновява:

Терминал
sudo certbot --nginx

Адресът на Jenkins и обратният прокси

След като 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 Compose
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
Терминал, с пакетите
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  1. Поставете тази парола на страницата Unlock Jenkins.
  2. Изберете Install suggested plugins, набора, който документацията съветва, когато още не сте сигурни от кои плъгини имате нужда; други се добавят по-късно в Manage Jenkins, Plugins.
  3. Създайте първия администратор, със силна парола. Ако пропуснете тази стъпка, акаунтът admin запазва паролата за отключване като своя парола.
  4. Задайте адреса на Jenkins, както в предишния раздел.

Съветникът оставя стратегията за оторизация „Logged-in users can do anything“: всеки влязъл акаунт има пълни права. Тя ви подхожда, докато акаунт имат само хора с пълно доверие. Преди да отворите повече акаунти, преминете към матричната сигурност, описана по-долу.

Компилациите на агентите, контролерът за оркестриране

Една компилация изпълнява команди, които контролират хора, различни от администратора: скриптове за компилиране, тестове, кода на всеки commit. На вградения възел тези команди имат същия достъп до файловата система на контролера като самия Jenkins. Затова документацията препоръчва да не пускате компилации на вградения възел и да ги предавате на агенти, което запазва и процесора и паметта на контролера за собствената му работа.

  1. Свържете поне един агент: друга машина, контейнер или облак. Агентът се нуждае от Java и от мрежова връзка с контролера.
  2. В Manage Jenkins, Nodes, отворете Built-In Node, после Configure, и задайте броя на изпълнителите на 0. Направете го, след като агентът е на мястото си, защото тогава компилациите чакат агент, за да започнат. Docker образът задава 2 по подразбиране.
ВръзкаКакОт страна на мрежата
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 толкова гъвкав, а всеки от тях е код, който работи в контролера. 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

Документацията определя резервните копия на контролера като критично важни: те служат за възстановяване след авария, за връщане на конфигурация, променена по грешка, или на повреден или изтрит файл. Всичко се намира в 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 ключ; пълното възстановяване се нуждае от него.

С Docker Compose

README на образа моли да третирате jenkins_home като база данни. Спрете Jenkins за времето на копирането, после архивирайте тома с временен контейнер, по метода от документацията на Docker:

Терминал, в папката на compose.yaml
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
docker compose pull
docker compose up -d
Терминал, с пакетите
sudo apt update
sudo apt install jenkins

Кой какво прави на Managed VPS

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Jenkins остава ваш софтуер, с неговите pipelines, настройки и данни.

ТемаНашите екипиВие
СървърътОбновления на системата и на сигурността, включително намеси на сървъраМоментът, който пасва на вашата дейност
НаблюдениетоСървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането виЧетенето на журналите на вашата инстанция и на компилациите ви
JenkinsПроактивно проследяване: грешки, забавяния и дисково пространство се откриват, препоръчва се корекцияИнсталирането, обновяванията, плъгините и настройките му, които прилагате вие или вашият AI асистент
Pipelines и агентитеСървърите, които ги носят, наблюдавани и архивираниЗадачите, агентите, акаунтите, правата и идентификационните данни
Резервните копияВсяка нощ, криптирани и пазени извън машината; възстановяването е включеноАрхивите, специфични за Jenkins, файлът master.key и заявката за възстановяване, когато ви потрябва
МиграциятаСегашният ви сървър е мигриран, безплатноМоментът на превключването

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.

Jenkins, на сървър, поддържан вместо вас

С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Jenkins, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.

Разгледайте Managed VPS

Често задавани въпроси

Безплатен ли е Jenkins за фирма?

Да. Jenkins е с лиценз MIT: можете да го използвате, променяте и пускате във фирмата си, без да купувате лиценз, стига да запазите бележката за авторските права и за лиценза. Остава цената на сървърите, които носят контролера и агентите.

Коя версия на Jenkins да инсталирам?

Линията LTS, която документацията представя като готова за работна среда: 2.580.2 към 28 октомври 2026 г. Тя изисква Java 21 или Java 25. Нова базова версия LTS се избира на всеки 12 седмици, а всяка базова версия получава три версии с поправки.

Как се инсталира Jenkins с Docker?

Използвайте официалния образ jenkins/jenkins с етикет LTS, като lts-jdk25, и именуван том, монтиран на /var/jenkins_home. Поставете пред него обратен прокси с HTTPS, например Caddy в същия файл compose.yaml, после задайте публичния адрес като адрес на Jenkins.

Къде се намира началната администраторска парола на Jenkins?

В журнала при стартиране и във файла secrets/initialAdminPassword на JENKINS_HOME: /var/jenkins_home с Docker образа, /var/lib/jenkins с пакетите. Поставете я на страницата Unlock Jenkins, после създайте собствения си администраторски акаунт.

Трябва ли компилациите да се изпълняват на контролера на Jenkins?

Документацията препоръчва да ги изпълнявате на агенти: на вградения възел компилацията има същия достъп до файловете на контролера като Jenkins. Свържете агент, през SSH или WebSocket, после задайте изпълнителите на вградения възел на 0.

Как се защитава инстанция на Jenkins?

Предоставяйте я през HTTPS зад обратен прокси, преминете към матричната сигурност, запазете Overall/Administer за хора с доверие, оставете защитата от CSRF включена, пускайте компилациите на агенти и прилагайте своевременно версиите LTS, които носят поправки за сигурността.

Как се архивира Jenkins?

Архивирайте JENKINS_HOME при спряна услуга или чрез моментна снимка на файловата система. Дръжте secrets/master.key извън това копие, пазен отделно на много сигурно място, и проверявайте всяко резервно копие, като го възстановявате на тестов Jenkins, стартиран на друг порт.

Покрива ли Managed VPS Jenkins?

Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.

Източници и официална документация

Свържете се с нас