RailWise KB已发布

视频教程：OS 系统安装与初始化配置

本教程配套文档演示 RAILWISE-OS 监测单位业务操作系统的安装、初始化配置、组织架构搭建和基础权限设置，帮助监测单位快速部署业务管理系统。

复核 2026-07-09入门公开可引用RailWise 技术团队

learning-path

视频教程：OS 系统安装与初始化配置

视频时长：约 15 分钟
难度：中级（需具备服务器基础操作能力）
目标：完成 RAILWISE-OS 的安装、初始化配置，搭建组织架构并设置基础权限

视频概述

本视频面向监测单位 IT 管理员、系统管理员和项目经理，演示 RAILWISE-OS 监测单位业务操作系统的完整安装与初始化流程。通过本教程，您将学会：

准备 OS 部署环境并完成系统安装
进行初始化配置（企业信息、品牌定制、系统参数）
搭建组织架构（部门、岗位、人员）
配置基础权限体系（角色、权限、数据范围）
完成系统基础数据配置（客户、项目类型、监测标准库）

视频内容结构

章节	时间点	内容
系统概述	00:00 - 01:00	OS 产品定位、功能模块、部署模式
环境准备	01:00 - 03:00	服务器要求、依赖安装、网络配置
系统安装	03:00 - 05:30	部署包下载、安装脚本、服务启动
初始化配置	05:30 - 08:00	企业信息、品牌定制、系统参数
组织架构搭建	08:00 - 10:30	部门创建、岗位设置、人员导入
权限体系配置	10:30 - 12:30	角色定义、权限分配、数据范围
基础数据配置	12:30 - 14:00	客户管理、项目类型、标准库
常见问题	14:00 - 14:45	安装失败、配置错误、权限问题
课后练习	14:45 - 15:00	练习任务布置

前置知识

具备 Linux 服务器基础操作能力
了解基本的数据库概念（PostgreSQL）
了解企业组织架构和权限管理的基本概念
拥有一台满足最低配置要求的服务器

步骤详解

步骤 1：系统概述（00:00 - 01:00）

视频画面：OS 系统界面展示、功能模块导航、架构概览

RAILWISE-OS（Operating System）是面向工程监测单位的业务操作系统，覆盖监测业务全生命周期：

┌─────────────────────────────────────────────────────────────┐
│                    RAILWISE-OS 功能架构                       │
├─────────────┬─────────────┬─────────────┬─────────────────────┤
│   业务管理层  │   外业执行层  │   数据处理层  │     报告交付层      │
├─────────────┼─────────────┼─────────────┼─────────────────────┤
│ • 项目管理   │ • 任务派发   │ • 数据校验   │ • 报告模板引擎      │
│ • 合同管理   │ • 外业APP   │ • 异常预警   │ • 自动排版生成      │
│ • 客户管理   │ • 设备管理   │ • 趋势分析   │ • 电子签章          │
│ • 财务管理   │ • 人员调度   │ • 数据归档   │ • 多格式导出        │
│ • 档案管理   │ • 轨迹记录   │ • 质量评定   │ • 在线审阅          │
├─────────────┼─────────────┼─────────────┼─────────────────────┤
│                    系统支撑层                                │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐│
│  │组织架构 │ │权限管理 │ │流程引擎 │ │日志审计 │ │系统配置 ││
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘│
└─────────────────────────────────────────────────────────────┘

部署模式

部署模式	适用规模	配置要求	特点
SaaS 云端	任意规模	无需服务器	即开即用，按量付费
私有化单机	50人以下	8C16G	本地部署，数据不出域
私有化集群	50-500人	16C32G × 3	高可用，支持负载均衡

[截图占位符：OS 系统界面概览、功能模块导航]

步骤 2：环境准备（01:00 - 03:00）

视频画面：服务器配置检查、依赖安装过程

2.1 服务器配置要求

环境	CPU	内存	磁盘	网络	操作系统
开发/测试	4 核	8 GB	100 GB SSD	百兆	Ubuntu 22.04
生产（<50人）	8 核	16 GB	500 GB SSD	千兆	Ubuntu 22.04 LTS
生产（50-200人）	16 核	32 GB	1 TB SSD	千兆	Ubuntu 22.04 LTS
生产（200+人）	32 核+	64 GB+	2 TB SSD	万兆	Ubuntu 22.04 LTS

2.2 安装依赖

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装基础依赖
sudo apt install -y curl wget git unzip nginx

# 安装 Docker（如未安装）
curl -fsSL https://get.docker.com | sh
sudo systemctl start docker
sudo systemctl enable docker

# 安装 Docker Compose
sudo apt install docker-compose-plugin

# 验证安装
docker --version
docker compose version

2.3 网络配置

# 开放必要端口
sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw allow 8080/tcp  # OS 管理端口（可选）
sudo ufw enable

# 配置域名（如有）
# 编辑 /etc/hosts 或配置 DNS 解析

[截图占位符：服务器配置检查、依赖安装输出]

步骤 3：系统安装（03:00 - 05:30）

视频画面：部署包下载、解压、安装脚本执行、服务启动

3.1 下载部署包

# 创建安装目录
mkdir -p /opt/railwise-os
cd /opt/railwise-os

# 下载部署包（从 RailWise 官方或企业分发平台）
wget https://releases.railwise.cn/os/3.2.0/os-deploy.tar.gz

# 解压
tar -xzf os-deploy.tar.gz
cd os-deploy

3.2 目录结构

os-deploy/
├── docker-compose.yml          # 服务编排
├── .env.example                # 环境变量模板
├── nginx/
│   ├── nginx.conf              # 反向代理配置
│   └── ssl/                    # SSL 证书目录
├── init-scripts/
│   ├── init-db.sql             # 数据库初始化
│   └── init-data.sh            # 基础数据初始化
├── scripts/
│   ├── install.sh              # 安装脚本
│   ├── start.sh                # 启动脚本
│   ├── stop.sh                 # 停止脚本
│   └── backup.sh               # 备份脚本
└── config/
    ├── application.yml         # 应用配置
    └── logback.xml             # 日志配置

3.3 配置环境变量

# 复制环境变量模板
cp .env.example .env

# 编辑配置
nano .env

核心配置项：

# 基础配置
COMPOSE_PROJECT_NAME=railwise-os
TZ=Asia/Shanghai

# 数据库配置
DB_HOST=postgres
DB_PORT=5432
DB_NAME=railwise_os
DB_USER=railwise_os
DB_PASSWORD=YOUR_STRONG_PASSWORD

# Redis 配置
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=YOUR_STRONG_PASSWORD

# 应用配置
APP_PORT=8080
APP_JWT_SECRET=YOUR_JWT_SECRET
APP_UPLOAD_PATH=/data/uploads

# 邮件配置（可选）
SMTP_HOST=smtp.railwise.cn
SMTP_PORT=587
SMTP_USER=notify@railwise.cn
SMTP_PASSWORD=YOUR_SMTP_PASSWORD

生产环境请务必修改所有默认密码，建议使用 openssl rand -base64 32 生成高强度密码。

3.4 执行安装

# 添加执行权限
chmod +x scripts/*.sh

# 执行安装脚本
./scripts/install.sh

安装脚本执行流程：

检查系统环境和依赖
加载环境变量配置
创建数据目录和日志目录
初始化数据库（创建表结构、基础数据）
启动服务（PostgreSQL → Redis → 后端服务 → 前端服务 → Nginx）
执行健康检查
输出访问地址和初始管理员账号

3.5 预期输出

[RailWise OS] 安装中...
✓ 系统环境检查通过
✓ Docker 版本: 26.1.0
✓ Docker Compose 版本: v2.27.0
✓ 环境变量加载完成
✓ 数据目录创建完成
✓ 数据库初始化完成
✓ 服务启动完成
✓ 健康检查通过

═══════════════════════════════════════════
  RAILWISE-OS 安装成功
═══════════════════════════════════════════
  管理后台:  http://localhost:8080
  初始管理员账号:
    用户名: admin@railwise.cn
    密码:   RailWise@2025

  请立即登录并修改默认密码！
═══════════════════════════════════════════

[截图占位符：安装脚本执行过程、安装成功输出]

步骤 4：初始化配置（05:30 - 08:00）

视频画面：Web 管理后台登录、企业信息配置、品牌定制、系统参数设置

4.1 登录管理后台

打开浏览器，访问 http://localhost:8080
使用初始管理员账号登录：
- 用户名：admin@railwise.cn
- 密码：RailWise@2025
首次登录强制修改密码

4.2 企业信息配置

进入 系统设置 → 企业信息
填写企业基本信息：

字段	示例值	说明
企业全称	宁波睿威工程技术有限公司	营业执照名称
企业简称	宁波睿威	系统显示名称
统一社会信用代码	9133XXXXXXXXXXXXXX	营业执照代码
企业地址	浙江省宁波市鄞州区XX路XX号	办公地址
联系电话	0574-XXXXXXXX	对外联系电话
企业邮箱	info@railwise.cn	对外联系邮箱
企业官网	https://railwise.cn	官方网站

4.3 品牌定制

进入 系统设置 → 品牌定制
上传企业 Logo（建议尺寸：200×60px，PNG 格式）
设置主题色：
- 主色：#B45309（琥珀铜色）
- 辅色：#1E40AF（深蓝）
- 成功色：#059669（绿色）
- 警告色：#D97706（橙色）
- 危险色：#DC2626（红色）
设置登录页背景图（可选）
设置系统名称显示：
- 浏览器标题：宁波睿威 - 监测业务管理系统
- 页脚版权信息：© 2025 宁波睿威工程技术有限公司版权所有

4.4 系统参数配置

进入 系统设置 → 系统参数
配置业务参数：

参数项	示例值	说明
默认坐标系统	CGCS2000	监测项目默认坐标系统
默认监测等级	二级	新项目默认监测等级
数据保留期限	7年	监测数据保留年限
报告归档期限	10年	报告文件保留年限
文件上传大小限制	100MB	单文件最大上传大小
批量导入最大行数	10000	Excel/CSV 批量导入最大行数
密码有效期	90天	用户密码强制更换周期
登录失败锁定次数	5次	连续登录失败锁定账号次数
会话超时时间	8小时	用户无操作自动退出时间

[截图占位符：企业信息配置界面、品牌定制界面、系统参数设置界面]

步骤 5：组织架构搭建（08:00 - 10:30）

视频画面：组织架构树、部门创建、岗位设置、人员导入

5.1 创建部门

进入 组织架构 → 部门管理
点击 新建部门，创建顶层部门：

宁波睿威工程技术有限公司
├── 管理层
│   ├── 总经理室
│   └── 技术总监室
├── 技术部
│   ├── 监测一室
│   ├── 监测二室
│   └── 数据处理组
├── 市场部
│   ├── 业务一组
│   └── 业务二组
├── 财务部
├── 综合部
│   ├── 人力资源
│   └── 行政管理
└── 项目部
    ├── 项目一组（深基坑方向）
    ├── 项目二组（盾构方向）
    └── 项目三组（桥梁方向）

操作步骤：

点击 新建部门
填写部门信息：
- 部门名称：监测一室
- 上级部门：技术部
- 部门负责人：（后续设置）
- 部门职能：负责深基坑及一般监测项目的技术实施
点击保存
重复上述步骤创建所有部门

5.2 设置岗位

进入 组织架构 → 岗位管理
创建岗位体系：

岗位名称	所属部门	岗位级别	岗位职责
总经理	总经理室	高管	公司全面管理
技术总监	技术总监室	高管	技术质量总负责
部门经理	各部门	中层	部门管理
项目经理	项目部	中层	项目管理
监测工程师	技术部/项目部	专业	监测技术实施
数据处理员	技术部	专业	数据处理分析
报告编制员	技术部	专业	报告编制
现场技术员	项目部	执行	现场观测
业务员	市场部	执行	市场开拓
财务人员	财务部	执行	财务管理
行政人员	综合部	执行	行政支持

5.3 导入人员

方式一：批量导入（推荐）

下载人员导入模板（Excel）
填写人员信息：

姓名	工号	手机号	邮箱	部门	岗位	入职日期	状态
张三	RW001	138****0001	zhangsan@railwise.cn	监测一室	监测工程师	2020-03-01	在职
李四	RW002	139****0002	lisi@railwise.cn	监测二室	项目经理	2019-06-15	在职
王五	RW003	137****0003	wangwu@railwise.cn	数据处理组	数据处理员	2021-09-01	在职

保存文件，进入 组织架构 → 人员管理 → 批量导入
上传文件，确认字段映射
点击导入

方式二：单个添加

进入 组织架构 → 人员管理 → 新增人员
填写人员信息
点击保存

[截图占位符：组织架构树、部门创建对话框、人员导入界面]

步骤 6：权限体系配置（10:30 - 12:30）

视频画面：角色管理、权限分配、数据范围设置

6.1 系统预设角色

OS 系统预设以下角色：

角色	权限范围	适用人员
系统管理员	全部功能 + 系统配置	IT 管理员
企业管理员	全部业务功能 + 企业设置	总经理/技术总监
部门经理	本部门及下属部门数据	各部门经理
项目经理	负责项目的数据	项目经理
监测工程师	项目数据查看 + 数据录入	监测工程师
数据处理员	数据处理 + 报告编制	数据处理员
现场技术员	现场数据录入 + 巡查记录	现场技术员
业务员	客户信息 + 项目信息查看	业务员
财务人员	合同 + 收款数据	财务人员
只读用户	查看报表和图表	业主/监理

6.2 自定义角色

如需创建自定义角色：

进入 系统设置 → 权限管理 → 角色管理
点击 新建角色
填写角色信息：
- 角色名称：高级监测工程师
- 角色描述：具备监测数据审核权限的工程师
- 复制自：监测工程师（继承基础权限）
在权限树中勾选额外权限：
- ✅ 数据审核
- ✅ 报告审核
- ✅ 预警确认
点击保存

6.3 数据范围配置

进入 系统设置 → 权限管理 → 数据范围
配置各角色的数据可见范围：

角色	数据范围	说明
系统管理员	全部数据	无限制
企业管理员	全部数据	无限制
部门经理	本部门及下属部门	部门树范围
项目经理	负责的项目	项目维度
监测工程师	参与的项目	项目成员维度
业务员	自己的客户	客户负责人维度
财务人员	全部合同和收款	业务模块维度

6.4 人员授权

进入 组织架构 → 人员管理
点击人员行末的授权按钮
分配角色：
- 主角色：监测工程师
- 附加角色：数据处理员（如兼岗）
设置数据范围（如与角色默认不同）
点击保存

[截图占位符：角色管理界面、权限树勾选、数据范围配置、人员授权界面]

步骤 7：基础数据配置（12:30 - 14:00）

视频画面：客户管理、项目类型配置、监测标准库导入

7.1 客户管理

进入 客户管理 → 客户列表
点击 新建客户
填写客户信息：

字段	示例值	说明
客户名称	宁波市轨道交通集团	客户全称
客户类型	业主单位	业主/施工方/监理/设计
联系人	王经理	主要联系人
联系电话	0574-XXXXXXXX	联系人电话
联系地址	宁波市鄞州区XX路XX号	客户地址
信用等级	A	客户信用评级
合作状态	合作中	合作中/潜在/终止

点击保存

7.2 项目类型配置

进入 系统设置 → 基础数据 → 项目类型
系统预设项目类型：

项目类型	代码	默认监测等级	适用规范	默认模板
深基坑监测	DEEP_EXCAVATION	二级	GB 50497	深基坑监测方案
盾构隧道监测	SHIELD_TUNNEL	一级	GB 50911	盾构监测方案
地铁保护区监测	METRO_PROTECTION	一级	CJJ/T 202	保护区监测方案
桥梁监测	BRIDGE	二级	JTG/T J21	桥梁监测方案
边坡监测	SLOPE	二级	-	边坡监测方案
管廊监测	UTILITY_TUNNEL	二级	-	管廊监测方案
房屋监测	BUILDING	三级	JGJ 8	房屋监测方案
文物监测	HERITAGE	一级	-	文物监测方案

可自定义添加项目类型

7.3 监测标准库导入

进入 系统设置 → 基础数据 → 标准库
系统内置常用标准：
- GB 50497-2019 建筑基坑工程监测技术标准
- GB 50911-2013 城市轨道交通工程监测技术规范
- JGJ 8-2016 建筑变形测量规范
- GB 50026-2020 工程测量标准
- CJJ/T 202-2013 城市轨道交通结构安全保护技术规范
如需添加其他标准：
- 点击 新增标准
- 填写标准编号、名称、发布日期、适用范围
- 上传标准 PDF 文件（可选）
- 点击保存

[截图占位符：客户管理界面、项目类型配置、标准库列表]

关键操作要点

要点 1：密码安全策略

# 生成高强度密码
openssl rand -base64 32

# 系统配置建议
密码最小长度：8位
密码复杂度：大写+小写+数字+特殊字符
密码有效期：90天
历史密码限制：最近5次不可重复
登录失败锁定：5次失败后锁定30分钟

要点 2：备份策略

# 自动备份配置（crontab）
0 2 * * * /opt/railwise-os/scripts/backup.sh >> /var/log/os-backup.log 2>&1

# 备份内容
- 数据库全量备份（pg_dump）
- 上传文件备份（tar）
- 配置文件备份（git）
- 保留策略：每日备份，保留30天

要点 3：系统升级

# 备份当前数据
./scripts/backup.sh

# 下载新版本
cd /opt/railwise-os
wget https://releases.railwise.cn/os/3.3.0/os-deploy.tar.gz

# 停止服务
./scripts/stop.sh

# 解压新版本
tar -xzf os-deploy.tar.gz

# 执行数据库迁移（如有）
docker compose exec api ./migrate.sh

# 启动服务
./scripts/start.sh

要点 4：日志查看

# 查看应用日志
docker compose logs -f api

# 查看前端日志
docker compose logs -f web

# 查看 Nginx 访问日志
docker compose logs -f nginx

# 查看全部日志
docker compose logs -f

常见问题（FAQ）

Q1: 安装时提示 “Docker 未安装”？

原因：系统未安装 Docker 或 Docker 服务未启动。

解决：

# 安装 Docker
curl -fsSL https://get.docker.com | sh

# 启动 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker

# 验证
docker --version

Q2: 数据库初始化失败？

原因：数据库密码错误或数据库连接问题。

解决：

检查 .env 中的 DB_PASSWORD 是否正确
检查 PostgreSQL 容器是否正常运行：docker compose ps postgres
查看数据库日志：docker compose logs postgres
手动执行初始化脚本：docker compose exec postgres psql -U railwise_os -d railwise_os -f /init-scripts/init-db.sql

Q3: 无法访问管理后台？

排查步骤：

检查服务状态：docker compose ps
检查端口是否被占用：netstat -tlnp | grep 8080
检查防火墙设置：sudo ufw status
查看应用日志：docker compose logs api

Q4: 人员导入失败？

原因：Excel 格式错误或必填字段缺失。

解决：

使用系统提供的导入模板
确保必填字段（姓名、工号、部门、岗位）已填写
确保部门名称和岗位名称与系统中已创建的一致
检查手机号和邮箱格式是否正确

Q5: 权限配置后用户无法看到数据？

原因：数据范围配置错误或角色权限不足。

解决：

检查用户分配的角色是否正确
检查角色的数据范围配置
确认用户是相关项目的成员
检查项目的数据权限设置（是否限制部门可见）

课后练习

练习 1：完成企业信息配置

登录 OS 管理后台
进入系统设置 → 企业信息
填写完整的企信息（可使用测试数据）
上传企业 Logo 和设置主题色
预览登录页面效果

练习 2：搭建完整组织架构

创建至少 5 个部门（含层级关系）
创建至少 8 个岗位
导入至少 10 名人员（使用批量导入）
为每个人员分配角色和数据范围

练习 3：配置权限体系

创建一个自定义角色“项目技术负责人”
配置该角色的权限：项目数据查看、数据审核、报告审核
将某人员授权为该角色
验证该人员登录后只能看到授权范围内的数据

练习 4：配置基础数据

添加至少 3 个客户
添加 1 个自定义项目类型
添加 1 个自定义监测标准
验证基础数据在项目创建时可用

视频资源

视频文件：video-os-01-installation-init.mp4
部署脚本包：os-deploy-sample.zip
人员导入模板：personnel-import-template.xlsx
讲义下载：handout-os-01.pdf
字幕文件：video-os-01-installation-init.srt

视频教程：OS 系统安装与初始化配置

视频教程：OS 系统安装与初始化配置

视频概述

视频内容结构

前置知识

步骤详解

步骤 1：系统概述（00:00 - 01:00）

部署模式

步骤 2：环境准备（01:00 - 03:00）

2.1 服务器配置要求

2.2 安装依赖

2.3 网络配置

步骤 3：系统安装（03:00 - 05:30）

3.1 下载部署包

3.2 目录结构

3.3 配置环境变量

3.4 执行安装

3.5 预期输出

步骤 4：初始化配置（05:30 - 08:00）

4.1 登录管理后台

4.2 企业信息配置

4.3 品牌定制

4.4 系统参数配置

步骤 5：组织架构搭建（08:00 - 10:30）

5.1 创建部门

5.2 设置岗位

5.3 导入人员

步骤 6：权限体系配置（10:30 - 12:30）

6.1 系统预设角色

6.2 自定义角色

6.3 数据范围配置

6.4 人员授权

步骤 7：基础数据配置（12:30 - 14:00）

7.1 客户管理

7.2 项目类型配置

7.3 监测标准库导入

关键操作要点

要点 1：密码安全策略

要点 2：备份策略

要点 3：系统升级

要点 4：日志查看

常见问题（FAQ）

Q1: 安装时提示 “Docker 未安装”？

Q2: 数据库初始化失败？

Q3: 无法访问管理后台？

Q4: 人员导入失败？

Q5: 权限配置后用户无法看到数据？

课后练习

练习 1：完成企业信息配置

练习 2：搭建完整组织架构

练习 3：配置权限体系

练习 4：配置基础数据

相关文档链接

视频资源

元数据标签