Windows 安装 eLabFTW 详细教程

eLabFTW 是一款免费开源的电子实验记录本（ELN），专为实验室设计，支持实验记录、试剂管理、数据分享。本教程详细介绍两种在 Windows 上安装 eLabFTW 的方法。

一、什么是 eLabFTW？

eLabFTW（Electronic Lab Notebook for The World）是一款面向科研人员的电子实验记录系统，核心功能包括：

• **实验记录**：Markdown 编辑器，支持附件上传
• **试剂管理**：内置化学品数据库，支持扫码入库
• **协议模板**：可复用的实验 SOP 库
• **团队协作**：多用户权限管理
• **数据导出**：PDF、JSON 格式导出

官方Demo体验：https://demo.elabftw.net

二、系统要求

⚠️ Windows 家庭版用户建议升级到专业版，或使用 VirtualBox 方案。

三、方法一：Docker Desktop 安装（推荐）

Docker 是官方推荐方案，功能完整，升级方便。

3.1 启用 WSL2

打开 PowerShell（管理员），执行：

Bash

wsl --install

重启电脑后，在 PowerShell 中验证：

Bash

wsl --list --verbose

3.2 安装 Docker Desktop

1. 下载地址：[https://www.docker.com/products/docker-desktop/](https://www.docker.com/products/docker-desktop/)

1. 运行安装程序，**勾选"Use WSL 2 instead of Hyper-V"**

1. 安装完成后，启动 Docker Desktop，等待右下角图标显示"Docker Desktop is running"

3.3 配置 Docker

打开 WSL2 终端（Ubuntu 或 PowerShell），设置 Docker 镜像加速（国内用户）：

Bash

sudo mkdir -p /etc/dockersudo tee /etc/docker/daemon.json <<-'EOF'{  "registry-mirrors": [    "https://docker.mirrors.ustc.edu.cn",    "https://hub-mirror.c.163.com"  ]}EOFsudo systemctl daemon-reloadsudo systemctl restart docker

3.4 部署 eLabFTW

在 WSL2 终端中执行：

Bash

# 创建安装目录mkdir -p ~/elabftw && cd ~/elabftw# 下载官方安装脚本curl -o install.sh https://get.elabftw.net/install.sh# 运行安装（交互式）bash install.sh

安装过程会提示选择：

• **安装模式**：生产环境（生产环境）
• **域名**：填写服务器域名或本机 IP
• **管理员账号**：设置管理员邮箱和密码

3.5 目录结构

安装完成后，eLabFTW 相关文件位于：

Python

~/elabftw/├── docker-compose.yml      # 容器编排配置├── .env                    # 环境变量（数据库密码等）├── uploads/               # 上传的文件└── mysql/                 # 数据库文件

3.6 常用 Docker 命令

Bash

cd ~/elabftw# 启动服务docker compose up -d# 查看运行状态docker compose ps# 查看日志docker compose logs -f# 停止服务docker compose down# 更新到最新版本docker compose pull && docker compose up -d

3.7 访问 eLabFTW

打开浏览器，访问：

Python

http://localhost:8080

或填写服务器 IP：

Python

http://192.168.x.x:8080

💡 首次使用需要配置域名和 SSL 证书（生产环境）。本地测试可先跳过 HTTPS。

四、方法二：VirtualBox 虚拟机安装

适合 Windows 家庭版用户，或不想启用 WSL2 的用户。

4.1 下载 Ubuntu 镜像

下载地址：https://ubuntu.com/download/desktop（选择 Ubuntu 22.04 LTS）

4.2 安装 VirtualBox

下载地址：https://www.virtualbox.org/wiki/Downloads

安装时注意勾选"Host Only Network"网络适配器。

4.3 创建虚拟机

1. 打开 VirtualBox，点击"新建"
2. 名称：Ubuntu-22.04-elabftw
3. 类型：Linux，版本：Ubuntu (64-bit)
4. 内存：4096 MB（推荐 8 GB）
5. 硬盘：50 GB（动态分配）

4.4 安装 Ubuntu

1. 加载下载的 Ubuntu ISO 镜像
2. 启动虚拟机，按提示安装
3. 安装时勾选"安装 OpenSSH Server"
4. 安装完成后，更新系统：

Bash

sudo apt update && sudo apt upgrade -y

4.5 在虚拟机中安装 eLabFTW

Bash

# 安装必要工具sudo apt install -y curl# 下载安装脚本curl -o install.sh https://get.elabftw.net/install.sh# 运行安装bash install.sh

4.6 端口转发配置

在 VirtualBox 中设置端口转发（虚拟机 → 设置 → 网络 → 端口转发）：

访问方式：打开宿主机浏览器，访问 http://localhost:8080

五、初始化配置

5.1 首次设置向导

首次访问时，eLabFTW 会引导完成初始化：

1. **创建团队**：填写团队名称（如"纤维测试实验室"）
2. **管理员账号**：设置管理员邮箱、密码
3. **时区设置**：选择 Asia/Shanghai（北京时间）
4. **语言**：选择 简体中文

5.2 重要功能配置

进入"管理面板"（头像 → 管理面板）：

• **用户管理**：添加团队成员，设置权限
• **实验模板**：创建标准化实验模板
• **化学品数据库**：配置试剂库
• **邮件通知**：配置 SMTP（支持 163 邮箱、企业微信等）

5.3 配置邮件通知（以 163 邮箱为例）

在管理面板 → 邮件设置：

Python

SMTP 服务器：smtp.163.com端口：465（SSL）或 587（TLS）用户名：your_email@163.com密码：邮箱授权码（不是登录密码）发件人地址：your_email@163.com

🔑 163 邮箱授权码获取：163邮箱网页 → 设置 → POP3/SMTP/IMAP → 开启服务 → 获取授权码

六、使用指南

6.1 创建实验记录

1. 点击左侧"实验" → "新建实验"
2. 填写实验标题、日期、状态
3. 使用 Markdown 编辑器记录实验步骤
4. 支持拖拽上传图片、PDF、数据文件
5. 点击"保存"或"分享"

6.2 使用实验模板

1. 进入"模板"页面
2. 创建标准实验流程模板
3. 新建实验时选择"从模板创建"
4. 模板可包含预设步骤、试剂、参数

6.3 化学品管理

1. 进入"物品" → "化学品"
2. 点击"添加"，输入 CAS 号自动识别化学品信息
3. 支持扫码枪扫码入库
4. 可记录存放位置、剩余量、供应商信息

七、常见问题

Q1：Docker 启动失败，提示"WSL2 not installed"

解决方法：

Bash

# 以管理员身份打开 PowerShellwsl --install# 重启电脑

Q2：eLabFTW 页面显示"502 Bad Gateway"

解决方法：

Bash

cd ~/elabftwdocker compose logs nginx    # 查看 nginx 日志docker compose restart        # 重启所有容器

Q3：数据库连接失败

解决方法：

Bash

cd ~/elabftwdocker compose exec mysql mysql -u elabftw -p# 输入 .env 中的 MYSQL_PASSWORD

Q4：上传文件失败，提示存储空间不足

解决方法：检查 docker-compose.yml 中的数据卷配置，确保数据持久化到宿主机：

YAML

volumes:  - ./uploads:/elabftw/uploads  - ./mysql:/var/lib/mysql

Q5：如何备份数据？

Bash

cd ~/elabftw# 备份数据库docker compose exec -it mysql mysqldump -u elabftw -p elabftw > backup_$(date +%Y%m%d).sql# 备份上传文件tar -czf uploads_$(date +%Y%m%d).tar.gz uploads/

八、数据安全建议

1. **定期备份**：建议每周完整备份一次数据
2. **SSL 证书**：生产环境务必启用 HTTPS，可使用 Let's Encrypt 免费证书
3. **访问控制**：通过路由器设置 IP 白名单，限制公网访问
4. **密码策略**：强制使用强密码，定期更换

九、卸载 eLabFTW

Bash

cd ~/elabftw# 停止并删除容器docker compose down# 删除数据卷（⚠️ 会删除所有数据）docker volume rm $(docker volume ls -q -f name=elabftw)# 删除安装目录rm -rf ~/elabftw

📌 **官方文档**：[https://doc.elabftw.net/](https://doc.elabftw.net/)

💬 **社区论坛**：[https://www.elabftw.net/forum/](https://www.elabftw.net/forum/)

🐛 **问题反馈**：[https://github.com/elabftw/elabftw/issues](https://github.com/elabftw/elabftw/issues)

如果觉得有帮助，欢迎转发给有需要的同学！