第一次打开
服务端装好之后，第一次用浏览器打开它，会看到一个“初始化“的页面。 这一页只出现这一次，走完它就再也不会出现了。
它的作用是三件事：连上数据库 → 把表建好 → 建一个管理员账号。
什么时候用它
只在第一次装完、或者换了新数据库的时候。平时用不到。
操作步骤
第一步：打开它
在服务器上打开浏览器，地址栏里敲：
http://本机地址:19090
其中 19090 是药掌柜默认用的端口。如果装的时候让我们的实施同事改过，
以他给你的那个为准。
地址敲对了，出来的就是这个页面（截图是还没连数据库时的样子）：
页面上方那条黄条是正常的，不是报错。它的意思是“还没配数据库“， 这正是第一次打开该有的样子。上面还贴心地写了一句： 数据库配置其实已经好了的话，点下面的「重试连接」试试。
第二步：填数据库连接
从上往下填：
| 格子 | 填什么 | 我们一般怎么填 |
|---|---|---|
| 数据库类型 | 两个大方块，点一下选中。药掌柜两种都支持 | 选 SQL Server |
| 主机 | 数据库装在哪儿 | 数据库和药掌柜装同一台机器，就填 127.0.0.1 |
| 端口 | 数据库听哪个口 | SQL Server 填 1433（默认就是这个） |
| 数据库名 | 给这套药掌柜的库起个名字 | 随便起，比如 YAOZHANGGUI。别用中文，别有空格 |
| 账号 | 用哪个数据库账号连 | 一般就是 sa |
| 口令 | 上面那个账号的口令 | 你在装 SQL Server 那一步自己设的 |
下面那个勾选框「自动创建数据库」：
- 勾上（默认）：药掌柜会自己去建那个库。前提是上面这个账号有建库权限 ——
用
sa就一定有权； - 不勾：你得先自己用 SQL Server 把库建好，药掌柜只往里建表。 你的数据库管理员不给你建库权限时，才需要这样。
为什么用 sa
sa 是 SQL Server 自带的超级管理员账号，一定存在、一定有权限，
所以第一次装最省事。装好之后想换成权限小一点的专用账号，也可以，见系统配置。
填完先别急着下一步，点一下「测试连接」：
- 出绿色的成功提示 → 继续；
- 出红色报错 → 看下面的「常见疑问」，九成是 TCP/IP 没打开。
第三步：填管理员账号
这一段是给你自己建登录账号用的，跟上面的数据库账号是两回事。
| 格子 | 填什么 |
|---|---|
| 管理员账号 | 以后登录药掌柜用的账号名。默认 admin |
| 管理员口令 | 装的时候留空就是内置的初始口令。具体是什么，装机的人手上那份资料里有，这里不写出来 |
| 若库中已有该账号，按上面的口令重置 | 第一次装不用管它 |
初始口令上线前一定要改
药掌柜内置了一个初始口令，为的是“装上就能进“，省得第一次卡在门口。
这个口令是公开资料里不该出现的东西，所以我们不把它印在说明书上。 装机的人知道它，装完上线之前一定要改掉。
登录之后，看左边菜单最下面那一行 —— 「退出系统」旁边就是「修改口令」，点一下就改。 只要还在用初始口令，药掌柜界面上会一直提示你，改掉了提示才消失。
第四步：部署名称和中心地址（可以先跳过）
- 部署名称：给这套系统起个名字，比如“甲地店·服务器“。 只有在一家店装了好几台服务器的时候才有用，用来区分。可以留空；
- 冬阳授权中心地址：填我们给你的那个地址（默认是
http://127.0.0.1:9100， 那是给我们自己开发用的，你要改成我们给你的）。
中心地址填错了不影响你现在装完用，只影响以后激活授权和在线更新。 拿不准就留着，以后再改。
第五步：点「开始初始化」
点下去之后，药掌柜会：
- 连上数据库；
- 把需要的库建出来（如果勾了自动创建）；
- 把系统表建好，登记好权限项；
- 把你刚才填的管理员账号建出来。
跑完就会自动跳到登录页。用刚才那个管理员账号登录进去，就算装好了。
接下来还有两件事：让收银机连上来（见收银机接入）， 以及激活授权（见激活与授权）。
界面上都是什么
这一页分三段，从下往上依次是「数据库 → 管理员 → 其他」，顺序不能乱 —— 因为库连不上，后面两段填了也白填。
| 这一段 | 干什么 | 填错了会怎样 |
|---|---|---|
| 上面：数据库类型 + 连接信息 | 告诉药掌柜“数据存哪儿“ | 连不上，初始化根本起不来 |
| 中间：管理员账号 | 建你的登录账号 | 口令忘了就要联系管理员重置 |
| 下面：部署名称 + 中心地址 | 可选信息 | 不影响装机，只影响以后的授权和更新 |
常见疑问
点「测试连接」报连不上数据库？
按这个顺序查，九成是第一条：
- SQL Server 的 TCP/IP 协议没打开。 这是最常见的坑 —— SQL Server 默认只允许本机用管道连，不允许走网络。要到 「SQL Server 配置管理器 → SQL Server 网络配置 → 实例的协议」里， 把 TCP/IP 改成“已启用“，然后重启 SQL Server 服务；
- 端口不是固定的。 在 TCP/IP 属性里看一下 IP 地址页签， 「TCP 端口」要写死一个数（比如 1433），不能是空的或者动态的；
- Windows 防火墙挡了 1433。 在防火墙里给 1433 端口放行；
- 口令里有特殊字符。 试着改用纯数字字母的口令排除一下。
「自动创建数据库」勾了但报没权限？
换一个有建库权限的账号（比如 sa），或者让数据库管理员先把库建好，
然后把勾去掉再点初始化。
初始化跑到一半失败了，能重来吗？
能，直接再点一次就行。 已经建好的表它不会重复建，失败的那一步会接着跑。
管理员口令忘了怎么办？
找我们的实施同事，用数据库工具把那个账号的口令重置掉。 所以上线前把口令改成你自己记得住的，并记在安全的地方。
页面上写的「Kernel 框架」「冬阳授权中心」是什么？
那是我们内部对这套底层框架的称呼，普通用户不用管它， 当成“药掌柜的服务端“理解就行。
本页修订记录
| 说明版本 | 日期 | 对应系统版本 | 改了什么 |
|---|---|---|---|
| v1 | 2026-10-07 | 框架 1.0.91 | 第一版，按新目录结构重写，补逐格说明和配图 |