在局域网安装bitwarden密码管理软件

为了满足局域网内部部署bitwarden软件用于局域网内部员工使用密码管理。

安装环境是在Ubuntu20环境。

1.首先要安装docker和docker-compose这两个软件。

 apt-get upgrade   #首先更新apt

docker run -d -p 6379:6379 --name nginx nginx:latest #拉取并运行nginx镜像。

netstat -lptn   #检查6379端口是否启动。

curl -fsSL https://get.docker.com -o get-docker.sh   #通过curl获取docker的sh可执行文件

sh get-docker.sh        #执行可编译文件

 若需要共享数据则要在执行命令中使用-v，采取localDir:ImgDir的形式进行设置。

 docker-compose安装过程

curl -L "https://github.com/docker/compose/releases/download/2.23.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

chmod +x /usr/local/bin/docker-compose

在下载docker-compose的时候下载速度很慢，所以我选择了在github直接下载软件，记住要根据主机系统和系统字节号选择指定的版本。将软件放到/usr/local/bin目录下，并且给添加可执行权限。（可能需要重启Linux系统）

2. 安装bitwarden

cd /usr/local/bin

./bitwarden.sh install

 此时会下载bitwarden所需要的镜像。

 

• Enter the domain name for your Bitwarden instance
  输入你要给 Bitwarden 分配的域名，这里所需要输入的信息是你的域名地址，下一个步骤会根据这个域名地址去注册服务，若该域名地址无效或者不能在公网DNS服务器找到的话则无法完成LetsEncrypt提供的SSL证书生成。所以若设置了一个无法生成SSL证书的域名则要在下一步中选择no，否则会报错。

• Do you want to use Let’s Encrypt to generate a free SSL certificate? (y/n)
  是否使用 Let's Encrypt 自动生成免费的 SSL 证书，一般选 y 。在这个过程中，由于我没有申请公网域名，也没有可以使用的SSL证书，所以我选择了n。

• Enter the database name for your Bitwarden instance
  输入用于 Bitwarden 的数据库名称

• Enter your installation id / Enter your installation key
  访问 Requesting Hosting Installation ID & Key | Bitwarden 输入个人信息获取ID和Key。

tips：因为我是局域网安装并且没有公网域名地址和SSL证书。所以在不选择LetsEncrypt去生成SSL证书后，会继续走下面的步骤，在走到最后几步时会告知缺乏SSL证书，这些都选择yes，在最后一个步骤是否需要安装组件时则要选择yes。最后完成安装。

安装完成之后可以关闭/etc/local/bin/bwdata/config.yml配置文件里面的SSL开关，设置为false

cd /usr/local/
cd bin/

vim bwdata/config.yml

3. 运行bitwarden

./bitwarden start

•  执行第一次时需要下载多个镜像依赖，所以该过程会比较慢，等启动完成之后观察每个镜像是否都是healthy状态，有些服务启动较慢，可能要等会才能从unhealthy转为healthy。
• 若不想用默认的80端口也可以在config.yml文件下面修改端口号然后重新启动bitwarden。

    测试bitwarden是否启动成功：输入localhost打开网页。

修改hosts文件使得服务可以被访问

首先在主机的hosts文件上添加域名信息。

127.0.0.1    bitwarden.XXXXXXXX.com    #注册的域名地址

若要发放给其他同个网段的主机使用，则需要在其自身机子的hosts文件添加主机IP和域名。例如

192.168.2.13    bitwarden.mydaemon.com

 接着测试功能启用是否正常。

选择自托管服务，然后输入https://域名.com保存。或者用IP地址直接访问网页。然后提交注册邮箱地址，开始使用。

4. 后续设置

• 若需要添加SSL证书或者要放到公网访问则需要申请公网域名地址，根据公网域名地址获得SSL证书后设置到bitwarden里面。 

bitwarden的数据会保存在bwdata/目录下面，每一天都会生成一份数据，并且保留30天。若后续需要进一步操作则根据其他文章去操作。

 最后附上参考文章，在此特别感谢作者提供的帮助。

一、Docker与Docker Compose 安装入门教程 - Debian / Ubuntu 配置国内镜像源方法 - ShyuRongLi - 博客园 (cnblogs.com)搭建自己的私人密码库！Bitwarden 部署安装教程 (免费 1Password 替代品) - ShyuRongLi - 博客园 (cnblogs.com)