❓ 常见问题

emlog用的什么编辑器？

emlog 系统默认使用的是 Markdown 编辑器，Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。 Markdown的出现让我们不需要去纠结各种文字样式和排版问题，重新回归到内容本身，注重文章本身的结构，而不是样式，发布以来深受广大专业内容创作者的喜爱。

在开始之前可以熟悉下 markdown 的语法：Markdown的基本语法
这是一个markdown的视频教程，花5分钟了解下吧： https://www.bilibili.com/video/BV1734y1e7QC
如果我还是喜欢原来所见即所得的编辑器，怎么办？可以安装使用：富文本编辑器插件。

如何在默认编辑器中设置文字颜色？

Markdown 可以通过 HTML 标签来设置文字颜色。不过要注意的是，Markdown 本身并不支持直接设置文字颜色，需要嵌入 HTML 代码才能实现。例如：

<span style="color:red">这是一行红色的字</span>
<span style="color:blue">这是一行蓝色的字</span>
<span style="color:green">这是一行绿色的字</span>

直接在编辑器内输入如上代码即可设置文字颜色。

如何在编辑器中插入B站视频？

在B站视频下方，点赞、投币、收藏，旁边有一个分享按钮，鼠标移上去会出现浮窗，点击【嵌入代码】，就可以复制嵌入代码了。在编辑器中黏贴该代码即可（Tinymce编辑器插件需要切换到源代码模式）。
如果嵌入的视频窗口较小，可以增加 width="800" height="450" 参数来控制视频显示尺寸。如下示例：

<iframe src="//player.bilibili.com/player.html?isOutside=true&aid=113780696614274&bvid=BV1LmrVYCEXa&cid=27730316916&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" width="800" height="450"></iframe>

后台编辑器等图标无法正常展示，都是小方块怎么解决？

如果是 Windows 操作系统IIS服务器部署emlog，可能会遇到浏览器找不到字体文件（woff/woff2）产生的错误。这样会导致浏览器无法加载字体图标，这是因为服务器IIS不认woff/woff2 文件类型的原因。以下是解决方案（也可以自己搜索："IIS 字体不显示" ，网上也有很多解决该问题的文章）：

打开IIS，在主界面中点击MIME类型：
手动添加MIME类型：
- .woff application/x-font-woff
- .woff2 application/x-font-woff
添加完成后，刷新页面就行了。

如果上面方法未能解决，检查是否开启了静态 CDN，emlog 是动态系统并不支持静态CDN，开启可能会导致字体加载出现跨域问题，无法加载，出现图标无法展示的问题，请关闭CDN。

如何隐藏管理后台登录页面？

系统不支持直接修改 admin 目录名来隐藏登录界面，修改会带来各种意外问题，如果你依然想这么做，可以在根目录下 config.php 文件末尾增加如下配置代码（如果已经有了，修改即可）

const ADMIN_PATH_CODE = 'xxx';

将xxx替换为8-16位的字母数字，不得包含特殊字符。
修改完成后只能访问：http://yourdomain/admin/account.php?action=signin&s=xxx 来登录后台。
修改后可能影响新用户注册功能，我们并不建议使用该功能。

忘记密码怎么办？

如果配置了邮件通知功能，可以直接在后台登录页面使用找回密码功能来重置密码。

也可以使用emlog密码重置工具来重置密码，按照如下步骤操作：

下载重置密码工具，并将下载的zip包解压。
将解压后的 pw.php 文件上传到emlog站点的根目录。
在浏览器里访问：你网站的域名/pw.php 按照提示操作重置密码。重置后务必删除该文件。

如何上传大文件？

修改php配置文件 php.ini，把 upload_max_filesize 和 post_max_size 修改为2000M（可以修改为你想要的大小），然后重启PHP。
nginx：修改配置文件 nginx.conf，在http段中加入 client_max_body_size 20000M;（可以修改为你想要的大小），然后重启nginx。
Apache：修改配置文件 httpd.conf，linux服务器一般可以在 /etc/httpd/conf/ 目录，修改字段（没有则添加） LimitRequestBody 1048576000 （限制为1000M），并重启apache服务

首页混乱样式丢失怎么解决？

进入管理后台，左侧系统菜单、点击设置、进入基础设置页面，检查【站点地址】设置是否正确，比如开启https后没有改为https开头，或者更换了域名设置还是旧的域名。

应用商店和检查更新都提示网络错误是什么原因？

出现该问题是因为系统无法访问emlog官网服务器导致的，解决方案如下：

确认服务器PHP是否支持curl扩展，查看后台首页软件信息部分是否有curl字样，如果没有请安装。
可以通过切换PHP版本来尝试解决。
提工单给服务商: 要求检查主机或者服务器是否可以对外请求官网域名： https://www.emlog.net ，可以让其尝试: telnet emlog.net 443
另外一些虚拟主机限制对外发包请求，建议更换云服务器。

应用商店无法下载安装包，提示：安装失败、无法下载安装包

如果应用商店可以看到商品列表，但是无法下载安装，一般是因为PHP的最大执行时间（max_execution_time）设置的较短，导致执行超时。可以调整 php.ini 的 max_execution_time 设置为 300，然后重启PHP，再尝试。

出现SQL语句报错是什么原因？

可以更换默认模板检查是否是因为模板引起，如果是请联系模板作者解决。
可以通过挨个禁用插件来检查是否是插件引起的，如果定位到插件问题，可以删除该插件或者联系插件作者解决。

提示目录不可写该如何解决？

需要设置整个站点 www 用户可写（一般是设置文件所有者为www，权限为755），如下图宝塔面板权限设置。

进入宝塔面板左侧菜单：文件
找到emlog搭建的站点文件夹，并点击右边【权限】设置
按照下图设置，755权限、所有者www、应用到子目录

如何给站点更换域名?

可以在应用商店搜索安装【工具箱】插件： https://www.emlog.net/plugin/detail/622

安装启用插件后，可以使用插件提供的更换域名功能。

更换服务器如何迁移站点？

详见文档：更换服务器

如何配置服务器支持 URL 重写（伪静态规则）?

Nginx

宝塔面板：站点设置 - 伪静态 - 选择emlog的规则 - 点击保存即可
手动配置：修改 Nginx 配置文件在站点相关配置中增加如下规则：

location / {
   index index.php index.html;
   if (!-e $request_filename){
      rewrite ^/(.*)$ /index.php last;
   }
}

Apache

根目录下已经配置了静态规则文件 .htaccess 文件，内容如下：

<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteBase /
    RewriteRule . /index.php [L]
</IfModule>

如果静态规则没有生效，需要修改Apache服务器配置开启支持.htaccess，检查 http.conf 配置文件：

确保已加载mod_rewrite模块，去掉如下配置行前的#注释符号
```
LoadModule rewrite_module modules/mod_rewrite.so
```
将AllowOverride指令设置为All
```
AllowOverride All
```

Caddy

在Caddyfile中添加如下配置：

example.com {
    # 伪静态规则：如果文件或目录不存在，则转发到 index.php
    try_files {path} {path}/ /index.php
}

Windows IIS

IIS6

找到 httpd.ini 文件（通常位于 C:\Program Files\ISAPI_Rewrite\ 或安装目录下），配置如下内容：

[ISAPI_Rewrite]
# 3600 = 1 hour
CacheClockRate 3600
RepeatLimit 32
RewriteRule /robots.txt(.*) /robots.txt$1 [L]
RewriteRule /rss.php(.*) /rss.php$1 [L]
RewriteRule /tb.php(.*) /tb.php$1 [L]
RewriteRule /favicon.ico /favicon.ico [L]
RewriteRule /xmlrpc.php(.*) /xmlrpc.php$1 [L]
RewriteRule /wlwmanifest.xml /wlwmanifest.xml [L]
RewriteRule /(t|m)$ /$1/ [R] RewriteRule /(admin|content|include|t|m)/(.*) /$1/$2 [L]
RewriteRule /install.php(.*) /install.php$1 [L]
RewriteRule /up(d.d.d)to(d.d.d).php(.*) /up$1to$2.php$3 [L]
RewriteRule ^/$ /index.php [L]
RewriteRule /(.*) /index.php/$1 [L]

IIS7/8/10

在站点根目录创建文件 web.config，填写下面内容即可

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="emlog Rewrite" stopProcessing="true">
                    <match url="^(.*)" ignoreCase="false" />
                    <conditions logicalGrouping="MatchAll">
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="/index.php" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

如何更换默认的🌵浏览器图标？

检查主题设置中是否提供了更换浏览器图标功能，有的话可以直接修改。
根目录下找到 favicon.ico 文件，用自己制作的同名文件替换即可，替换后记得清理浏览器缓存。推荐使用在线工具制作自己的站点 icon 图标，比如：https://www.logosc.cn/logo/favicon

如何在首页底部添加公安备案号？

进入后台左侧菜单：系统-设置，在基础设置中找到【首页底部信息】，填写如下代码（如果已经有其他代码直接追加在后面即可），并将其中 xxxxxxx 以及 “京” 替换为你自己所在地公安备案信息和编号。

<a target="_blank" href="https://beian.mps.gov.cn/#/query/webSearch?code=xxxxxxx" style="display: inline-flex; align-items: center;">
  <img src="https://beian.mps.gov.cn/img/logo01.dd7ff50e.png" alt="icp" style="width: 16px; height: 16px; vertical-align: middle;">
  <span style="color:#939393; margin-left: 4px;">京公网安备 xxxxxxx号</span>
</a>

如何添加网站统计代码？

在应用商店搜索安装：自定义head标签插件，安装启用插件后，可以使用插件提供的全局head标签内填写统计代码。

如何设置CDN？

emlog是动态站点，并不支持全站都开启CDN缓存，如果强行开启，可能出现各种功能异常。建议配置规则只针对图片、视频、下载文件等静态资源开启CDN缓存，其他动态请求不开启CDN缓存。但并不是说CDN就对emlog没用，有些CDN除了提供缓存功能，还提供频率控制等安全防护功能，比如：腾讯云 EdgeONE，还是可以继续使用，只是需要注意规则，不要缓存动态请求。

如何进行定制开发？

emlog是完全开源的，可以进行定制开发，但是如果修改了核心文件（除后续安装的模板和插件外的系统文件），下次更新版本修改会被覆盖。如果有定制开发需求，请要求开发者开发插件或者主题来实现定制功能，而不是直接修改核心文件，这样不影响后续升级新版本。

如何禁止搜索引擎收录站点？

修改根目录下的 robots.txt 文件，删除原来的全部内容，改成下面的内容。修改后大部分搜索引擎都会遵守robot协议不再爬取你的站点。

User-agent: *
Disallow: /

网站出现502怎么解决？

502通常是PHP运行异常导致的，检查php是否正常启动状态，可以尝试重启PHP，如果重启依然无法解决，可以尝试安装其他版本的PHP（比如7.4、8.1），然后切换网站使用的PHP版本，还可以尝试卸载PHP重新安装。

安装应用失败，提示：请安装php的Zip扩展，如何解决？

如果是宝塔面板安装的PHP，可以尝试切换 PHP 版本到 7.4 或者 8.1 来解决。其他情况可能需要手动安装 php 的 zip 扩展，具体安装方式很多，可以自行搜索： xx操作系统下安装PHP 的 zip 扩展。

安装某个插件后导致网站无法访问怎么办？

首先建议切换 PHP 版本到 7.4 或者 8.1 尝试解决，如何无法解决，可以使用插件禁用工具来禁用后续安装的所有插件，按照如下步骤操作：

下载禁用插件工具，并将下载的zip包解压。
将解压后的 em.php 文件上传到emlog站点的根目录。
在浏览器里访问：你网站的域名/em.php 按照提示操作禁用插件。使用后务必删除该文件。

如何让 emlog 搭建的站点更安全？

升级 emlog 到pro系列最新版本
切换 PHP到 7.4 或更高版本
禁用 PHP 函数：eval、assert ，宝塔面板 php 管理左侧菜单有禁用函数功能
禁用后台手动上传安装应用，参见文档：https://www.emlog.net/docs/install/config
避免使用弱密码，比如纯数字或者纯字母，建议使用字母、数字、特殊字符组合，不低于 8 位
不要允许上传svg格式的图片
不在服务器上使用盗版、破解软件、源码
至少每周将文件和数据库数据导出异地备份（不要只备份在服务器）

emlog用的什么编辑器？​

如何在默认编辑器中设置文字颜色？​

如何在编辑器中插入B站视频？​

后台编辑器等图标无法正常展示，都是小方块怎么解决？​

如何隐藏管理后台登录页面？​

忘记密码怎么办？​

如何上传大文件？​

首页混乱样式丢失怎么解决？​

应用商店和检查更新都提示网络错误是什么原因？​

应用商店无法下载安装包，提示：安装失败、无法下载安装包​

出现SQL语句报错是什么原因？​

提示目录不可写该如何解决？​

如何给站点更换域名?

更换服务器如何迁移站点？​

如何配置服务器支持 URL 重写（伪静态规则）?​

Nginx​

Apache​

Caddy​

Windows IIS​

IIS6​

IIS7/8/10​

如何更换默认的🌵浏览器图标？​

如何在首页底部添加公安备案号？​

如何添加网站统计代码？​

如何设置CDN？​

如何进行定制开发？​

如何禁止搜索引擎收录站点？​

网站出现502怎么解决？​

安装应用失败，提示：请安装php的Zip扩展，如何解决？​

安装某个插件后导致网站无法访问怎么办？​

如何让 emlog 搭建的站点更安全？​