Ställa in självhostad bitwarden på Raspberry Pi

Bitwarden är en öppen källkodslösenordshanterare som hjälper dig att lagra och hantera dina referenser säkert. Att vara värd för din egen Bitwarden -server på en Raspberry Pi ger dig full kontroll över dina data och förbättrar säkerheten. I den här guiden kommer vi att leda dig genom processen att ställa in Bitwarden på en Raspberry Pi med Docker.


Vad du behöver

  1. Hallon (Alla modeller med tillräckliga resurser, PI 3 eller PI 4 rekommenderas)
  2. Raspberry Pi Os installerad och kör
  3. Hamnarbetare och Docker komponerar installerad
  4. Domännamn (Valfritt men rekommenderas för säker HTTPS -åtkomst)
  5. Internetanslutning för nedladdning av obligatoriska filer
  6. Bitwarden Docker-Compose.yml-fil

Steg 1: Uppdatera din Raspberry Pi

Innan du börjar är det viktigt att uppdatera din Raspberry Pi till den senaste versionen:

sudo apt update
sudo apt upgrade -y

Starta om din Raspberry Pi för att säkerställa att allt är uppdaterat:

sudo reboot

Steg 2: Installera Docker

Docker är ett verktyg som låter dig köra applikationer i containrar. Följ dessa steg för att installera Docker på din Raspberry Pi:

  1. Ladda ner och installera Docker med det officiella skriptet:
curl -sSL https://get.docker.com | sh
  1. Lägg till din användare i Docker -gruppen för att undvika att behöva sudo För Docker -kommandon:
sudo usermod -aG docker $USER
  1. Starta om Raspberry Pi för att tillämpa gruppändringarna:
sudo reboot
  1. Verifiera installationen:
docker --version

Steg 3: Installera Docker Compose

Docker Compose är ett verktyg för att definiera och köra applikationer med flera container Docker. Bitwarden kräver att flera containrar körs, och Docker Compose förenklar denna process.

  1. Ladda ner och installera Docker Compose:
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  1. Gör att dockaren komponera binär körbar:
sudo chmod +x /usr/local/bin/docker-compose
  1. Verifiera installationen:
docker-compose --version

Steg 4: Ladda ner Bitwarden Docker Compose -filer

Bitwarden tillhandahåller en officiell Docker Compose -installation för att distribuera sin server. Vi laddar ner och konfigurerar dessa filer:

  1. Skapa en katalog för att lagra Bitwarden -filerna:
mkdir ~/bitwarden
cd ~/bitwarden
  1. Klona Bitwarden -förvaret från GitHub:
git clone https://github.com/bitwarden/server.git .

Steg 5: Konfigurera bitwarden

Innan du kör Bitwarden måste du konfigurera den så att den matchar din miljö.

  1. Miljövariabler: I bwdata Mapp (skapad av Docker Compose) måste du konfigurera flera miljövariabler som databasen och krypteringsnycklarna. Du kan hänvisa till config.yml fil för att göra nödvändiga ändringar.
  2. Ställ in ett domännamn: Du kan valfritt använda ett domännamn för åtkomst till Bitwarden. Detta rekommenderas för säker HTTPS -åtkomst. Om du inte har en domän kan du hoppa över detta steg och använda din Pis lokala IP -adress.

Om du använder en domän, se till att uppdatera dina DNS -poster för att peka på Raspberry Pis IP -adress.


Steg 6: Ställ in SSL (https)

För att säkra Bitwarden -instansen rekommenderas det att använda HTTPS för kryptering. Du kan antingen använda ett självsignerat certifikat eller ett gratis SSL-certifikat från Let's Encrypt.

Använda låt oss kryptera med nginx (valfritt)

  1. Installera Ninx och Certbot För SSL -certifikathantering:
sudo apt install -y nginx certbot python3-certbot-nginx
  1. Skaffa SSL -certifikatet med CertBot:
sudo certbot --nginx -d yourdomain.com
  1. Följ instruktionerna på skärmen för att slutföra processen.

Steg 7: Starta Bitwarden med Docker Compose

Nu kan du starta Bitwarden -containrarna med Docker Compose.

  1. Navigera till bitwarden katalog:
cd ~/bitwarden
  1. Kör följande kommando för att starta Bitwarden:
docker-compose up -d

Detta kommando laddar ner de obligatoriska Docker -bilderna och kör Bitwarden i bakgrunden. Du kan kontrollera loggarna för att säkerställa att allt går smidigt:

docker-compose logs -f

Steg 8: Access Bitwarden

När containrarna är igång kan du komma åt Bitwarden -servern i din webbläsare:

  • Om du ställer in en domän, navigerar du till https://yourdomain.com
  • Om du använder Raspberry Pis IP -adress, navigera till http://<Pi_IP>:8080

Steg 9: Ställ in administratörspanelen (valfritt)

Om du vill komma åt Bitwarden Admin -panelen för att hantera användare och inställningar kan du skapa ett administratörskonto genom att följa dessa steg:

  1. Skapa en Bitwarden -katalog .env Fil med dina administratörsinställningar:
touch .env
  1. Lägg till följande innehåll i .env file:
# Admin username and password
ADMIN_EMAIL=admin@yourdomain.com
ADMIN_PASSWORD=your_secure_password
  1. Återuppbyggnad av Docker -behållaren för att tillämpa ändringarna:
docker-compose down
docker-compose up -d

Du kan nu komma åt administratörspanelen via webbgränssnittet.


Steg 10: Testa och använd Bitwarden

När allt är igång kan du testa Bitwarden -inloggningen genom att navigera till webbgränssnittet och logga in med de referenser du skapade. Du kan nu använda Bitwarden för att lagra och hantera lösenord säkert.


Felsökning

  • Bitwarden börjar inte: Kontrollera Docker -loggarna för att säkerställa att det inte finns några problem med containerinställningen:

    docker-compose logs -f
    
  • SSL -fel: Se till att ditt SSL -certifikat är korrekt installerat och domänen pekar på din Raspberry Pis IP.

  • Databasproblem: Se till att databas- och krypteringsnycklarna är korrekt konfigurerade i config.yml fil.


Slutsats

Genom att följa dessa steg har du framgångsrikt skapat en självhostad Bitwarden-lösenordshanterare på din Raspberry Pi. Denna installation ger ett säkert och privat sätt att hantera dina lösenord och referenser, och med Docker är det enkelt att underhålla och uppdatera. Njut av fördelarna med en självhostad lösenordshanterare!

Lämna en kommentar

Notice an Issue? Have a Suggestion?
If you encounter a problem or have an idea for a new feature, let us know! Report a problem or request a feature here.