At hoste Jenkins på en Managed VPS betyder, at du bygger, tester og udruller dine projekter fra en maskine, der er din egen, og som vores teams holder opdateret og overvåger dag og nat. Jenkins er fri software under MIT-licensen. Denne guide følger den officielle dokumentation: valg af LTS-versionen, installation med Docker Compose eller Linux-pakkerne, HTTPS og Jenkins-URL'en, agenter, rettigheder, plugins, backup og opgraderinger.
Af Simon Vasconcelos Lee
Udgivet den 16. november 2026Læsetid: 15 minutter
jenkins/jenkins og dets lts-tags eller med projektets Linux-pakker, bag en reverse proxy med HTTPS; angiv derefter den adresse som Jenkins-URL.JENKINS_HOME, opbevar secrets/master.key separat, og læs opgraderingsguiden for hver LTS, før du anvender den.Jenkins beskriver sig selv som den førende automatiseringsserver med åben kildekode. Den er bygget i Java og tilbyder over 2.000 plugins til at automatisere stort set alt. Dens README opregner de mest almindelige anvendelser: at bygge projekter, køre tests for at fange fejl, så snart de indføres, statisk kodeanalyse og udrulning.
Jenkinsfile, som dokumentationen anbefaler at committe i projektets versionsstyring.Jenkins udgives under MIT-licensen. Den tillader at bruge, kopiere, ændre, sammenflette, udgive, distribuere, underlicensere og sælge softwaren på én betingelse: at copyrightmeddelelsen og licensteksten følger med i hver kopi. Du kan altså køre Jenkins i din virksomhed, til dine egne projekter og til dine kunders, uden at skulle købe en licens.
Licensen dækker koden. Navnet «Jenkins» er et registreret varemærke tilhørende LF Charities, Inc., en organisation tilknyttet Linux Foundation, og projektet følger Linux Foundations varemærkepolitik. Den politik gælder for alle, der sætter ordet ind i navnet på deres eget produkt eller deres egen tjeneste, og den foreslår formuleringer som «dit produkt for Jenkins» til det formål: læs den, hvis du bygger et tilbud op omkring softwaren. At nævne Jenkins for at beskrive den, som denne guide gør, er rimelig brug.
Denne publikation er uafhængig af Jenkins-projektet, LF Charities, Inc. og Linux Foundation og er hverken tilknyttet, sponsoreret eller godkendt af dem.
Jenkins udkommer på to linjer. Weekly-versionen leverer nye funktioner og rettelser hver uge. LTS-linjen, for Long-Term Support, tager udgangspunkt i en weekly-version, der udvælges som basis hver 12. uge, og modtager derefter tilbageførte rettelser. Dokumentationen præsenterer Docker-imagets LTS-tags som den mere stabile version, klar til produktion: det er den, denne guide installerer.
| Linje | Pr. 8. november 2026 | Tempo |
|---|---|---|
| LTS | 2.580.2 fra den 28. oktober 2026, efter 2.580.1 fra den 30. september | Tre versioner pr. basis, .1, .2 og .3, hver efter to ugers tilbageføring og to ugers test |
| Weekly | 2.589 | Én version om ugen |
LTS 2.580.2 kræver Java 21 eller Java 25: med enhver anden version kører controlleren ikke. Projektet planlægger at stoppe understøttelsen af Java 21 i september 2027 og af Java 25 i september 2029. Kravet gælder for hele systemet, controller, agenter og kommandolinje; dine projekter bygges selv med den Java-version, der passer dem.
Dokumentationen anbefaler det officielle image jenkins/jenkins. Tagget lts følger LTS på Java 21, lts-jdk25 samme LTS på Java 25 og latest weekly-versionen. På en server, hvor Docker er installeret, opretter du en mappe og lægger denne compose.yaml i den, hentet fra dokumentationens Caddy-eksempel: Caddy modtager de besøgende på port 80 og 443, henter HTTPS-certifikatet og videresender til Jenkins, som kun kan nås på det interne netværk.
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: alle data ligger der, også plugins og konfiguration. Imagets README foretrækker dette volumen frem for en mappe på værten, som kan give problemer med rettigheder: brugeren jenkins i containeren har id 1000.web. Port 50000 bruges af indgående TCP-agenter; WebSocket- og SSH-agenter klarer sig uden den, så den publiceres ikke her.2.580.2-lts-jdk25 fastlægger versionen, mens lts-jdk25 følger den aktuelle LTS.Dokumentationen fastsætter et minimum på 256 MB hukommelse og 1 GB disk, mindst 10 GB i en Docker-container, og anbefaler 4 GB hukommelse eller mere og 50 GB disk eller mere til et lille team. Den forklarer, at controllerens hukommelse spænder fra 200 MB for en lille installation til over 70 GB for de største; hver forbundet agent optager 2 eller 3 tråde der, omkring 2 MB eller mere. Hovedparten af arbejdet, selve builds, kører på agenterne.
På en Managed VPS fortæller du os om dine projekter, og hvor ofte du bygger: vi anbefaler den størrelse, der passer til controlleren og til agenterne.
Projektet udgiver også pakker til Debian og Ubuntu, Fedora, Red Hat Enterprise Linux og dens afledninger. På Debian eller Ubuntu installerer du Java først: dokumentationen anbefaler det kraftigt, da Jenkins, der er installeret før Java, kan have svært ved at finde en gyldig Java-installation ved opstart.
sudo apt update
sudo apt install fontconfig openjdk-21-jre
java -version
Tilføj derefter LTS-repositoryet, debian-stable, med dets signeringsnøgle, og installér 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
Pakken opretter en systemd-tjeneste og en bruger jenkins, sender sin log til journald (journalctl -u jenkins.service), opbevarer sine data i /var/lib/jenkins og lytter på port 8080 på alle grænseflader. Bag en proxy på samme server begrænser du den til den lokale adresse med sudo systemctl edit jenkins og derefter sudo systemctl restart jenkins:
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"
Denne blok følger dokumentationens Nginx-eksempel, begrænset til dens blok location /, den form den giver til de tilfælde, hvor Nginx ikke selv læser Jenkins' filer:
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 uden afsluttende skråstreg: dokumentationen advarer om, at en skråstreg i slutningen af denne værdi giver problemer.Upgrade og Connection betjener WebSocket-agenterne, og map holder forbindelserne i live for resten af trafikken.proxy_request_buffering off er påkrævet for Jenkins-kommandoer fra kommandolinjen, der sendes over HTTP.client_max_body_size fastsætter den maksimale størrelse på uploads, 10 MB i eksemplet.Certbot installerer derefter certifikatet og sørger for at forny det:
sudo certbot --nginx
Når Jenkins er online, angiver du dens offentlige adresse, for eksempel https://jenkins.example.com/, under Manage Jenkins, System, i afsnittet Jenkins Location. Jenkins bruger den til alle de adresser, den genererer, i brugerfladen som i agenternes filer, og til at kommunikere med agenter og eksterne værktøjer. Portindstillingerne ændrer intet ved det: det er denne URL, der tæller.
Jenkins overvåger selv sin reverse proxy. Hvis den viser «It appears that your reverse proxy setup is broken», så kontrollér først, at denne URL svarer til den adresse, du bruger, og derefter, at proxyen sender X-Forwarded-Proto, når den modtager HTTPS, og taler med Jenkins over HTTP, som begge eksempler i denne guide gør.
Serveret under en sti som /jenkins frem for sit eget domænenavn skal Jenkins kende den sti: --prefix=/jenkins, via JENKINS_OPTS med Docker eller JENKINS_PREFIX med pakkerne. Dokumentationen anbefaler samme sti på begge sider, da en omskrivning i proxyen betyder, at rigtig mange adresser skal rettes.
Ved første adgang beder Jenkins om en automatisk genereret adgangskode, som den skriver i sin log og i secrets/initialAdminPassword. Åbn din HTTPS-adresse, og læs den derefter:
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
admin oplåsningsadgangskoden som sin adgangskode.Guiden lader autorisationsstrategien «Logged-in users can do anything» blive på plads: alle indloggede konti har fulde rettigheder. Den passer, så længe kun personer, du har fuld tillid til, har en konto. Før du åbner for flere konti, skifter du til matrixbaseret sikkerhed, som beskrives nedenfor.
Et build kører kommandoer, som andre end administratoren styrer: byggescripts, tests, koden i hvert commit. På den indbyggede node har disse kommandoer samme adgang til controllerens filsystem som Jenkins selv. Dokumentationen anbefaler derfor ikke at køre builds på den indbyggede node, men at overlade dem til agenter, hvilket også holder controllerens CPU og hukommelse til dens egen opgave.
| Forbindelse | Hvordan | Netværksmæssigt |
|---|---|---|
| SSH | Controlleren forbinder sig til agenten med pluginet SSH Build Agents | Ingen port skal åbnes på controlleren |
| WebSocket | Agenten forbinder sig til controlleren via dens HTTPS-adresse, siden Jenkins 2.217 | Ingen ekstra port: proxyen videresender WebSocket |
| Indgående TCP | Agenten forbinder sig til controlleren på en dedikeret TCP-port | En fast port, der skal åbnes og publiceres, 50000 i Docker-imaget |
Dokumentationen anbefaler generiske, udskiftelige agenter, forberedt med et værktøj til konfigurationsstyring, et færdigbygget image eller en container: en agent, der går ned, erstattes så uden besvær. Med en enkelt server foreslår den en agent, der kører som en anden bruger i styresystemet, uden læse- eller skriveadgang til JENKINS_HOME og uden sudo. På en Managed VPS kan en ekstra VPS også fungere som agent, dimensioneret til dine builds.
Adgangskontrollen fra agent til controller, som forhindrer en kompromitteret agent i at sende kommandoer til controlleren, er altid slået til siden Jenkins 2.326.
Jenkins adskiller godkendelse, som fastslår, hvem du er, fra autorisation, som siger, hvad du må gøre. Dens indbyggede brugerdatabase, der er slået til som standard, passer til små teams; LDAP, Active Directory, SAML eller OpenID Connect tilsluttes via plugins. Til autorisation er dette de strategier, dokumentationen beskriver:
| Strategi | Hvad den giver | Hvornår den skal vælges |
|---|---|---|
| Anyone can do anything | Fulde rettigheder, selv til anonyme besøgende | Kun til en lokal test |
| Logged-in users can do anything | Fulde rettigheder til alle indloggede konti; den indstilling, guiden efterlader | Så længe kun personer, du har fuld tillid til, har en konto |
| Matrix-based security | Rettigheder tildelt pr. bruger eller pr. gruppe | Det udgangspunkt, dokumentationen anbefaler til produktion |
| Project-based Matrix Authorization Strategy | Samme matrix, udvidet projekt for projekt | Til at forbeholde visse projekter visse personer |
Begge matrixstrategier kommer fra pluginet Matrix Authorization Strategy, som er blandt de plugins, guiden foreslår. Giv kun lidt til rækkerne anonymous og authenticated i matrixen: Overall/Administer givet til authenticated svarer til «Logged-in users can do anything». Vær lige så omhyggelig, hvis du åbner for selvregistrering eller en identitetsudbyder, hvor enhver kan oprette en konto.
JENKINS_HOME med nøglerne i mappen secrets, som afsnittet om backup behandler separat.Det er plugins, der gør Jenkins så alsidig, og hvert af dem er kode, der kører inde i controlleren. Jenkins kontrollerer Update Center én gang hver 24. time; opdateringerne vises under fanen Updates i Manage Jenkins, Plugins og træder i kraft efter en genstart. Knappen Check now gennemtvinger en kontrol.
Med Docker kan du også bygge dit eget image ud fra jenkins/jenkins og installere dine plugins i det med jenkins-plugin-cli, ud fra en liste plugins.txt, der fastlåser deres versioner, og som værktøjet kan opdatere. Imagets README beskriver denne metode.
Notifikationer om builds går gennem pluginet Mailer: et build, der fejler, en succes efter en fejl eller et build, der bliver ustabilt, udløser en e-mail. Afsenderserveren indstilles under Manage Jenkins, System, i afsnittet E-mail Notification.
På en Simafri VPS går afsendelsen gennem et autentificeret SMTP-relay på port 587: adressen på en mailkonto, du allerede har, eller Simafri Suite. I de avancerede indstillinger sætter du flueben ved Use SMTP Authentication med kontoens brugernavn og adgangskode og derefter ved Use TLS: pluginet bruger så port 587. Indstillingen Test configuration by sending test e-mail sender en testbesked.
Dokumentationen kalder backup af controlleren afgørende vigtig: den bruges til at genoprette efter en katastrofe og til at hente en konfiguration, der er ændret ved en fejl, eller en fil, der er blevet ødelagt eller slettet. Alt ligger i JENKINS_HOME: /var/jenkins_home i Docker-imaget, /var/lib/jenkins med pakkerne.
| Element | Hvad det rummer | Skal der tages backup |
|---|---|---|
*.xml, herunder config.xml | Hovedkonfigurationen og systemkonfigurationen | Obligatorisk |
jobs/ | Jobs og historik over builds; i builds/archive de arkiverede artefakter | Obligatorisk; artefakterne efter behov, de fylder meget |
plugins/*.jpi | De installerede plugins i deres versioner | Anbefalet, for at gendanne identisk |
secrets/ | Nøglerne, der krypterer adgangsoplysningerne | Mappen, undtagen master.key, som opbevares separat |
workspace/ | Filerne hentet fra versionsstyringen til builds | Valgfrit: en ny checkout genskaber dem |
war/, cache/, tools/ | Den udpakkede WAR, hentede og udpakkede værktøjer | Valgfrit: genskabes efter behov |
Dokumentationen beder dig om aldrig at lægge hovednøglen i din almindelige backup. secrets/master.key krypterer den nøgle, der beskytter dine adgangsoplysninger: den, der har dine backups og denne nøgle, kan læse alt. Kopiér den én gang, og opbevar den separat et meget sikkert sted, ligesom en privat SSH-nøgle; en fuld gendannelse kræver den.
Imagets README beder dig om at behandle jenkins_home som en database. Stop Jenkins, mens kopien laves, og arkivér derefter volumenet med en midlertidig container efter metoden i Dockers dokumentation:
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
En kopi, der laves med tjenesten stoppet, er konsistent. For at tage backup uden at stoppe peger dokumentationen på snapshots af filsystemet, LVM, btrfs eller ZFS, som er mere konsistente og hurtigere end en kopi under drift; blandt backupplugins med åben kildekode nævner den thinBackup som det eneste, der stadig vedligeholdes. Giv hver kopi et navn med tidsstempel, undgå /tmp, som kan blive tømt ved genstart, og send de færdige kopier til en ekstern server.
Lagt på serverens disk indgår disse arkiver også i dens natlige backup.
Dokumentationen beder dig om at validere hver backup og giver den enkle metode: gendan den i en midlertidig mappe, læg master.key tilbage, og start en anden Jenkins i samme version på den, på en anden port:
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999
Før hver opgradering af kernen læser du siden for den LTS, du sigter mod, i projektets opgraderingsguider: hvert afsnit dækker opgraderingen fra den forrige LTS. For 2.580.2 nævner den ingen væsentlige ændringer. For 2.580.1 bemærker den, at flere plugins, der er skilt ud fra kernen, ikke længere følger med i WAR-filen: Jenkins installerer dem selv, når Update Center kan nås. Tag derefter backup af JENKINS_HOME, og opgradér:
docker compose pull
docker compose up -d
sudo apt update
sudo apt install jenkins
Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; Jenkins forbliver din software, med dens pipelines, dens indstillinger og dens data.
| Emne | Vores teams | Dig |
|---|---|---|
| Serveren | Opdateringer af system og sikkerhed, indgreb på serveren inkluderet | Det tidspunkt, der passer til din drift |
| Overvågningen | Serveren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkald | Gennemlæsning af din instans' og dine builds' logfiler |
| Jenkins | Proaktiv opfølgning: fejl, langsomme svartider og diskplads opdages, og en rettelse anbefales | Installation, opdateringer, plugins og indstillinger, som du gennemfører, selv eller med din AI-assistent |
| Pipelines og agenter | De servere, der bærer dem, overvåget og sikkerhedskopieret | Jobs, agenter, konti, rettigheder og adgangsoplysninger |
| Backup | Hver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderet | De arkiver, der er specifikke for Jenkins, filen master.key og anmodningen om gendannelse, når du får brug for den |
| Migreringen | Din nuværende server flyttes, uden beregning | Tidspunktet for omlægningen |
Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.
Med en Managed VPS fra Simafri holder vores teams serveren bag din Jenkins-instans opdateret, overvåger den dag og nat og griber ind uden at vente på dit opkald; de følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører, selv eller med din AI-assistent. Backup krypteres hver nat og opbevares uden for maskinen, gendannelsen er inkluderet, og migreringen af din nuværende server sker uden beregning.
Ja. Jenkins er under MIT-licensen: du kan bruge, ændre og køre den i din virksomhed uden at skulle købe en licens, så længe du beholder dens copyright- og licensmeddelelse. Tilbage er udgiften til de servere, der bærer controlleren og agenterne.
LTS-linjen, som dokumentationen præsenterer som klar til produktion: 2.580.2 pr. 28. oktober 2026. Den kræver Java 21 eller Java 25. En ny LTS-basis udvælges hver 12. uge, og hver basis modtager tre versioner med rettelser.
Brug det officielle image jenkins/jenkins med et LTS-tag, som lts-jdk25, og et navngivet volumen monteret på /var/jenkins_home. Sæt en reverse proxy med HTTPS foran, for eksempel Caddy i samme compose.yaml-fil, og angiv derefter den offentlige adresse som Jenkins-URL.
I opstartsloggen og i filen secrets/initialAdminPassword i JENKINS_HOME: /var/jenkins_home med Docker-imaget, /var/lib/jenkins med pakkerne. Indsæt den på siden Unlock Jenkins, og opret derefter din egen administratorkonto.
Dokumentationen anbefaler at køre dem på agenter: på den indbyggede node har et build samme adgang til controllerens filer som Jenkins. Forbind en agent via SSH eller WebSocket, og sæt derefter den indbyggede nodes executors til 0.
Server den over HTTPS bag en reverse proxy, skift til matrixbaseret sikkerhed, forbehold Overall/Administer personer, du har tillid til, lad CSRF-beskyttelsen være slået til, kør builds på agenter, og anvend hurtigt de LTS-versioner, der indeholder sikkerhedsrettelser.
Arkivér JENKINS_HOME med tjenesten stoppet eller via et snapshot af filsystemet. Hold secrets/master.key uden for den backup, opbevaret separat et meget sikkert sted, og validér hver backup ved at gendanne den på en test-Jenkins, der startes på en anden port.
En Managed VPS dækker serveren: system, sikkerhed, overvågning og backup. Vores teams følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører. Et indgreb i selve applikationen faktureres pr. time eller som fast pris.
Simafri
Lad os tale om din hjemmeside
Fortæl os om dit projekt med få ord: vi vender hurtigt tilbage til dig.
Tak! Din forespørgsel er sendt. Vi vender tilbage til dig hurtigst muligt.
Foretrækker du e-mail? Skriv til os på support@simafri.com.