装服务端
药掌柜的“服务端“，指的就是装在你店里那台机器上的那一套东西：
一个程序（kernel.exe），加上它旁边的一批配置文件。
它一装好，全店的数据就都存在这台机器上。收银机那边不用装它， 连过来用就行 —— 那部分在收银机接入。
这一页讲三件事：怎么把它装起来、怎么启动、怎么确认它在跑。 装完打开浏览器会进初始化向导，那一步在第一次打开。
什么时候用它
- 装机前准备做完了，数据库已经能连上；
- 你拿到了我们给你的首装包（一个压缩包），要装到服务器上；
- 换了服务器，要重新装一遍。
操作步骤
第一步：解压到一个固定目录
首装包一般是个压缩文件，名字里带版本号。把它解压到一个目录。
“解压“就是把压缩包里的东西原样倒出来，放进一个正常的文件夹。 别直接在压缩包里双击里面的文件用 —— 那样它跑不起来。
目录挑在哪儿，有几条经验：
| 建议这样 | 原因是 |
|---|---|
放在数据盘，比如 D:\yaozhanggui | C 盘重装系统的时候容易被清掉 |
| 目录名用英文和数字 | 中文名容易和系统里的一些老组件闹别扭 |
| 放在这台机器自己的硬盘上 | 网络盘一断，它就停了 |
| 不要放桌面、不要放“下载“文件夹 | 这两个地方容易被清理、被同步软件搬走 |
装完就别再挪它了
这个程序有个脾气：它把自己所在的目录，当成自己的家。
配置、日志、各种记录，它都往这个目录里放。 所以你要是把文件夹挪个地方、或者给它改个名字，它就找不到原来那些东西了， 看起来就像“配置全丢了“。
想换目录，正确的做法是重新解压一份到新目录， 再从第一次打开走一遍，不要直接搬文件夹。
第二步：在安装目录里启动
进到刚解压出来的那个目录，找到 start-kernel.cmd，双击它。
.cmd 是 Windows 的一种启动脚本，你可以把它当成“双击就自动帮你敲一串命令的小纸条“。
双击之后会弹出一个黑色窗口，里面一行一行往下滚字。 这个窗口不能关 —— 它就是药掌柜在跑的样子。窗口一关，服务就停了。
窗口里滚的那些字，是它自己写下来的启动日志（就是“我做了什么“的记录）。 启动的时候，它会顺手核对一遍自己身上的文件： 我们发货的时候给每个文件都留了一份“指纹“，它开机时对一遍。 哪个文件被人动过，它就会在启动日志里用醒目的字标出来。 所以要是有人偷偷改了程序里的东西，你翻一下启动日志就知道了。
第三步：用浏览器打开它
服务端跑起来之后，在这台机器的浏览器里打开：
http://本机地址:19090
19090 是药掌柜默认用的端口。端口你可以理解成门牌号 ——
一台机器上跑着好几个程序，靠这个号区分谁是谁。
以后收银机也是靠“地址 + 门牌号“找到它。
第一次打开会进初始化向导：填数据库、建库建表、建管理员账号。 每个格子该填什么，在第一次打开里逐项写了。
初始化走完之后，打开就是这个登录页（你第一次打开看到的是向导，走完它才会跳到这里）：
让收银机也能连进来
上面这个地址，只保证这台机器自己打得开。要让收银机连上来，还有两件事：
- 在这台机器的防火墙里，放行
19090端口（做法在装机前准备里）； - 让我们的实施同事确认一下，服务端现在是“允许别的机器连“的状态。
第四步：装完建议做两件事
第一件：登记成开机自启。
“开机自启“的意思是：这台机器一开机，药掌柜自己就起来了， 不用每天喊人去双击一次。
服务端本身没带这个开关，我们一般是拿 Windows 自带的任务计划程序登记一条。 你说一声，我们的实施同事可以远程帮你登记好。
营业的店建议做这一步。早上开门忘了开服务器，收银台就开不了单， 而且从收银机那边看不出来是服务器没开。
第二件：把地址告诉收银机。
把这台机器的局域网地址抄下来，比如 192.168.1.50。
然后照收银机接入，在每台收银机上配一遍。
第五步：接着去激活
到这一步，服务端只是“装上了“，还没“能用“。登录进去之后还要激活授权， 见激活与授权。
界面上都是什么
服务端本身没有界面。你能看到的就是下面这几样：
| 你看到的 | 这是什么 | 要注意什么 |
|---|---|---|
| 一个黑色窗口 | 药掌柜正在跑，滚动的字是启动日志 | 别关它，一关服务就停 |
| 浏览器里的页面 | 药掌柜的操作界面 | 第一次打开是初始化向导，之后是登录页 |
| 安装目录里的文件 | kernel.exe 是程序本身，其它是配置和日志 | 平时不用去动它们 |
任务管理器里的 kernel.exe | 用来确认它还在不在跑 | 列表里找不到，就是已经停了 |
常见疑问
提示 19090 端口被占用了，怎么办？
先找出是谁占了这个门牌号，再决定是关掉它、还是给换一个。
端口被占用，意思是“19090 这个号已经挂在别的程序身上了“。常见两种情况：
- 药掌柜自己已经在跑了，你又双击了一次。去任务管理器里，把多出来的
kernel.exe结束掉，再重新启动一次就好； - 真的是别的程序占着。那就给药掌柜换一个号，比如
19091。 换号这件事，说一声让我们的实施同事帮你改 —— 改完以后，收银机那边的地址也要跟着改。
想自己看看是谁占的，在命令行里敲这一句：
netstat -ano | findstr 19090
最后那一列数字，是占用它的那个程序的编号（叫“进程号“）。 拿这个编号去任务管理器里「详细信息」那一页对，就知道是哪个程序了。
能不能装在 D 盘、E 盘？
能。装哪个盘都行，只要不是会被系统清掉、被软件搬走的地方。
我们一般建议 D:\yaozhanggui 这种规规矩矩的目录。有三个地方不要放：
- 不要放桌面、不要放“下载“文件夹；
- 不要放网盘同步目录（同步软件会把文件搬来搬去）；
- 不要放 U 盘、网络盘。
还有一条比“装哪个盘“更要紧：装完不要再挪动它。原因看上面那个黄条。
装完怎么确认它真的在跑？
两个办法，随便挑一个。
办法一：看浏览器。 打开 http://本机地址:19090。
能出页面就是它在跑 —— 还没初始化的时候出的是初始化向导，
初始化完了出的是登录页。
办法二：看任务管理器。 按 Ctrl + Shift + Esc 打开任务管理器，
切到「详细信息」那一页，在列表里找 kernel.exe。找得到，就是在跑。
另外记住一句：它跑着的时候，那个黑色窗口不能关。
怎么把它关掉？
对着那个黑色窗口按 Ctrl + C，或者直接点窗口右上角的叉。
关之前先看一眼：这会儿有没有收银员正在开单。 有人正在开单的时候关掉，那一单就存不下来了。 要停就提前喊一声，等大家都结完账再关。
窗口要是找不着了，就去任务管理器「详细信息」里找到 kernel.exe，
右键 → 「结束任务」。
关掉之后想再开，还是回安装目录双击 start-kernel.cmd。
已经卖出去的账不会丢 —— 账都存在数据库里，不在这个窗口里。
服务器重启之后，药掌柜要手动开吗？
没登记开机自启的话，要手动开一次。
表现很好认：收银机连不上，服务器上看着又一切正常 ——
其实就是没人去双击那个 start-kernel.cmd。
所以营业的店建议照上面第四步，把开机自启登记上。
本页修订记录
| 说明版本 | 日期 | 对应系统版本 | 改了什么 |
|---|---|---|---|
| v1 | 2026-10-07 | 框架 1.0.91 | 第一版 |