Hoste Jenkins® på en Managed VPS: dine builds på din egen server

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.

Simon Vasconcelos Lee Af Udgivet den 16. november 2026Læsetid: 15 minutter

Alle guider

Det vigtigste

  1. MIT-licensen tillader at bruge Jenkins frit i din virksomhed, så længe du beholder dens licensmeddelelse. Navnet hører særskilt under den varemærkepolitik, som projektet har vedtaget, nemlig Linux Foundations.
  2. Vælg LTS-linjen: 2.580.2 pr. 28. oktober 2026, som kører på Java 21 eller Java 25. En ny LTS-basis udvælges hver 12. uge.
  3. Installér med det officielle image jenkins/jenkins og dets lts-tags eller med projektets Linux-pakker, bag en reverse proxy med HTTPS; angiv derefter den adresse som Jenkins-URL.
  4. Kør builds på agenter, og sæt controllerens executors til 0. Tildel rettigheder med matrixbaseret sikkerhed, og lad CSRF-beskyttelsen være slået til.
  5. Tag backup af JENKINS_HOME, opbevar secrets/master.key separat, og læs opgraderingsguiden for hver LTS, før du anvender den.

Hvad Jenkins gør

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.

MIT-licensen og varemærket

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.

LTS eller weekly: hvilken version skal installeres

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.

LinjePr. 8. november 2026Tempo
LTS2.580.2 fra den 28. oktober 2026, efter 2.580.1 fra den 30. septemberTre versioner pr. basis, .1, .2 og .3, hver efter to ugers tilbageføring og to ugers test
Weekly2.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.

Installation med Docker Compose

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.

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
}
Terminal
docker compose up -d

Dimensionering af serveren

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.

Med Debian- eller Ubuntu-pakkerne

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.

Terminal
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:

Terminal
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:

Tilsidesættelse af tjenesten
[Service]
Environment="JENKINS_LISTEN_ADDRESS=127.0.0.1"

Med Nginx og Certbot

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:

Nginx-blok
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 installerer derefter certifikatet og sørger for at forny det:

Terminal
sudo certbot --nginx

Jenkins-URL'en og reverse proxyen

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.

Første start: den første adgangskode og installationsguiden

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:

Terminal, med Docker Compose
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
Terminal, med pakkerne
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  1. Indsæt denne adgangskode på siden Unlock Jenkins.
  2. Vælg Install suggested plugins, det sæt dokumentationen anbefaler, når du endnu ikke ved, hvilke plugins du har brug for; andre tilføjes senere under Manage Jenkins, Plugins.
  3. Opret den første administrator med en stærk adgangskode. Hvis du springer dette trin over, beholder kontoen admin oplåsningsadgangskoden som sin adgangskode.
  4. Angiv Jenkins-URL'en som i forrige afsnit.

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.

Builds på agenter, controlleren til at orkestrere

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.

  1. Forbind mindst én agent: en anden maskine, en container eller en cloud. Agenten skal have Java og en netværksforbindelse til controlleren.
  2. Under Manage Jenkins, Nodes åbner du Built-In Node, derefter Configure, og sætter antallet af executors til 0. Gør det, når en agent er på plads, for builds venter derefter på, at en agent starter. Docker-imaget sætter 2 som standard.
ForbindelseHvordanNetværksmæssigt
SSHControlleren forbinder sig til agenten med pluginet SSH Build AgentsIngen port skal åbnes på controlleren
WebSocketAgenten forbinder sig til controlleren via dens HTTPS-adresse, siden Jenkins 2.217Ingen ekstra port: proxyen videresender WebSocket
Indgående TCPAgenten forbinder sig til controlleren på en dedikeret TCP-portEn 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.

Konti og rettigheder

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:

StrategiHvad den giverHvornår den skal vælges
Anyone can do anythingFulde rettigheder, selv til anonyme besøgendeKun til en lokal test
Logged-in users can do anythingFulde rettigheder til alle indloggede konti; den indstilling, guiden efterladerSå længe kun personer, du har fuld tillid til, har en konto
Matrix-based securityRettigheder tildelt pr. bruger eller pr. gruppeDet udgangspunkt, dokumentationen anbefaler til produktion
Project-based Matrix Authorization StrategySamme matrix, udvidet projekt for projektTil 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.

Plugins og deres opdateringer

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 pr. e-mail

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.

Backup af JENKINS_HOME

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.

ElementHvad det rummerSkal der tages backup
*.xml, herunder config.xmlHovedkonfigurationen og systemkonfigurationenObligatorisk
jobs/Jobs og historik over builds; i builds/archive de arkiverede artefakterObligatorisk; artefakterne efter behov, de fylder meget
plugins/*.jpiDe installerede plugins i deres versionerAnbefalet, for at gendanne identisk
secrets/Nøglerne, der krypterer adgangsoplysningerneMappen, undtagen master.key, som opbevares separat
workspace/Filerne hentet fra versionsstyringen til buildsValgfrit: en ny checkout genskaber dem
war/, cache/, tools/Den udpakkede WAR, hentede og udpakkede værktøjerValgfrit: 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.

Med Docker Compose

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:

Terminal, i mappen med 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
Terminal, én gang: hovednøglen
docker cp jenkins:/var/jenkins_home/secrets/master.key ./master.key

Med pakkerne

Terminal
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.

Validér en 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:

Terminal
export JENKINS_HOME=/mnt/backup-test
java -jar jenkins.war --httpPort=9999

Opgraderinger

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:

Terminal, med Docker Compose
docker compose pull
docker compose up -d
Terminal, med pakkerne
sudo apt update
sudo apt install jenkins

Hvem gør hvad på en Managed VPS

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.

EmneVores teamsDig
ServerenOpdateringer af system og sikkerhed, indgreb på serveren inkluderetDet tidspunkt, der passer til din drift
OvervågningenServeren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkaldGennemlæsning af din instans' og dine builds' logfiler
JenkinsProaktiv opfølgning: fejl, langsomme svartider og diskplads opdages, og en rettelse anbefalesInstallation, opdateringer, plugins og indstillinger, som du gennemfører, selv eller med din AI-assistent
Pipelines og agenterDe servere, der bærer dem, overvåget og sikkerhedskopieretJobs, agenter, konti, rettigheder og adgangsoplysninger
BackupHver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderetDe arkiver, der er specifikke for Jenkins, filen master.key og anmodningen om gendannelse, når du får brug for den
MigreringenDin nuværende server flyttes, uden beregningTidspunktet 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.

Jenkins på en server, der passes for dig

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.

Opdag Managed VPS

Ofte stillede spørgsmål

Er Jenkins gratis for en virksomhed?

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.

Hvilken version af Jenkins skal man installere?

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.

Hvordan installerer man Jenkins med Docker?

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.

Hvor finder man Jenkins' første administratoradgangskode?

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.

Skal builds køre på Jenkins-controlleren?

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.

Hvordan sikrer man en Jenkins-instans?

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.

Hvordan tager man backup af Jenkins?

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.

Dækker en Managed VPS Jenkins?

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.

Kilder og officiel dokumentation

Kontakt os