❓ 常见问题

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>

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

如何在编辑器中插入视频（MP4)？

在编辑器中插入如下html代码，把其中mp4地址替换为你视频的地址即可。

<video class="video-js" controls preload="auto" width="100%" data-setup='{"aspectRatio":"16:9"}'>
    <source src="http://xxxx.com/content/uploadfile/202109/62351631420620.mp4" type='video/mp4'>
</video>

如何在编辑器中插入音频(MP3)？

在编辑器中插入如下html代码，把其中mp3地址替换为你音频mp3的地址即可。

<audio src="http://localhost:8080/content/uploadfile/202303/08361680144922.mp3" preload="none" controls loop>
    你的浏览器不支持 audio 标签。
</audio>

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

如果是 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语句报错是什么原因？

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

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

在安装应用或者上传文件的时候提示目录不可写，需要设置 content 目录下的 plugins、templates、uploadfile目录可写（一般是设置文件所有者为www，权限为755），如果是更新版本的时候提示目录不可写，需要设置整个站点www用户可写，如下图宝塔面板权限设置。

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

如何给站点更换域名?

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

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

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

将旧的服务器站点所有文件打包下载，并在 emlog 后台-系统-数据导出数据库备份。
在新的服务器安装一个同样版本号的 emlog。
在新的 emlog 后台-系统-数据，将第 1 步备份的数据库导入。
将旧服务器 content 目录上传覆盖到新服务器。
顺利的话，完成上面步骤迁移就完成了。

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

Nginx服务器

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

Apache服务器

只需要开启支持.htaccess，检查 http.conf 配置文件：

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

Windows IIS 服务器

IIS6

[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>

如何设置CDN？

emlog是动态站点，并不支持全站开启静态CDN，如果强行开启，后台功能可能出现各种异常。建议配置规则只针对图片、视频、下载文件等静态资源开启CDN缓存，其他动态请求不开启。也可以使用云存储插件将图片文件存储到七牛、阿里云等云存储空间，这些云空间都支持开启cdn。

如何进行定制开发？

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

如何添加流量统计代码？

流量统计工具往往要求把统计代码添加在 head 标签中，我们可以安装工具箱插件，进入代码注入菜单，将统计代码设置在全局head标签中。

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

修改根目录下的 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 扩展。

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

可以使用插件禁用工具来禁用后续安装的所有插件，按照如下步骤操作：

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

emlog用的什么编辑器？​

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

如何在编辑器中插入视频（MP4)？​

如何在编辑器中插入音频(MP3)？​

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

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

忘记密码怎么办？​

如何上传超大文件？​

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

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

正版注册失败如何解决？​

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

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

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

如何给站点更换域名?

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

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

Nginx服务器​

Apache服务器​

Windows IIS 服务器​

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

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

如何设置CDN？​

如何进行定制开发？​

如何添加流量统计代码？​

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

网站出现502怎么解决？​

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

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